home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / WG960214.ZIP / WTRGATE.DOC < prev    next >
Encoding:
Text File  |  1996-02-14  |  230.7 KB  |  5,883 lines
  1. W...W
  2. W.W.W
  3. .W.W.
  4.  
  5. WaterGate
  6.  
  7. Version 0.90
  8. Mail processor for Fidonet and Internet/Usenet
  9. Documentation 14/02/96
  10.  
  11. (c) Copyright 1993-1996 Waterline Software Development V.O.F.
  12. All Rights Reserved
  13.  
  14. Development by Ramon van der Winkel
  15.                Martijn Dijksterhuis
  16.                Michel van der Laan
  17.  
  18.  
  19.  
  20. (we have removed all the graphics and high-ASCII from this
  21. file, so it can be printed on any kind of printer in any kind
  22. of non-proportional font)
  23. WaterGate manual                                        [page i]
  24.  
  25. Table of contents
  26. -----------------
  27.  
  28. Introduction . . . . . . . . . . . . . . . . . . . . . . .   1
  29.      Features. . . . . . . . . . . . . . . . . . . . . . .   1
  30.      Requirements. . . . . . . . . . . . . . . . . . . . .   1
  31.      Welcome to WaterGate. . . . . . . . . . . . . . . . .   3
  32.      Contacting the authors. . . . . . . . . . . . . . . .   4
  33.      Support site, newsgroup and the mailing list. . . . .   4
  34.      Disclaimer, legal stuff, license, money and you!. . .   5
  35.  
  36. Installing WaterGate . . . . . . . . . . . . . . . . . . .   6
  37.      Program description . . . . . . . . . . . . . . . . .   6
  38.           The distribution system. . . . . . . . . . . . .   6
  39.           The gateway system . . . . . . . . . . . . . . .   7
  40.      UUCP for beginners. . . . . . . . . . . . . . . . . .   8
  41.           About UUCP . . . . . . . . . . . . . . . . . . .   8
  42.           Spool directory. . . . . . . . . . . . . . . . .   8
  43.           Compressed news and batch headers. . . . . . . .   9
  44.           UUCP Name and Domain addresses . . . . . . . . .   9
  45.      WaterGate terminology . . . . . . . . . . . . . . . .  10
  46.      User types. . . . . . . . . . . . . . . . . . . . . .  11
  47.  
  48. Step by step installation. . . . . . . . . . . . . . . . .  12
  49.      System settings . . . . . . . . . . . . . . . . . . .  14
  50.           SysOp. . . . . . . . . . . . . . . . . . . . . .  14
  51.           System path. . . . . . . . . . . . . . . . . . .  15
  52.           AreaFix and NewsFix. . . . . . . . . . . . . . .  15
  53.           Duplicates . . . . . . . . . . . . . . . . . . .  15
  54.           Max. open handles. . . . . . . . . . . . . . . .  16
  55.           Cache .TDB files . . . . . . . . . . . . . . . .  16
  56.           Oversized path . . . . . . . . . . . . . . . . .  16
  57.           Log file path. . . . . . . . . . . . . . . . . .  17
  58.           Use swap file? . . . . . . . . . . . . . . . . .  17
  59.           Swap file path . . . . . . . . . . . . . . . . .  17
  60.           Swap file size . . . . . . . . . . . . . . . . .  17
  61.  
  62. Setting up the Fido system . . . . . . . . . . . . . . . .  18
  63.      Fido AKAs . . . . . . . . . . . . . . . . . . . . . .  18
  64.      Fido Settings . . . . . . . . . . . . . . . . . . . .  20
  65.           Inbound directories. . . . . . . . . . . . . . .  20
  66.           Outbound directory . . . . . . . . . . . . . . .  20
  67.           Origin lines . . . . . . . . . . . . . . . . . .  21
  68.           Fido system. . . . . . . . . . . . . . . . . . .  21
  69.           Rescan file. . . . . . . . . . . . . . . . . . .  21
  70.           Max length settings. . . . . . . . . . . . . . .  22
  71.           Default groups . . . . . . . . . . . . . . . . .  22
  72.           ArcMail names. . . . . . . . . . . . . . . . . .  23
  73.      Fido MessageBases . . . . . . . . . . . . . . . . . .  24
  74.           Auto Link. . . . . . . . . . . . . . . . . . . .  24
  75.           Strip SEEN-BY. . . . . . . . . . . . . . . . . .  24
  76.           Replace Tearline . . . . . . . . . . . . . . . .  24
  77.           Default number and days. . . . . . . . . . . . .  25
  78.           Netmail messagebase. . . . . . . . . . . . . . .  25
  79.           Dupes messagebase. . . . . . . . . . . . . . . .  25
  80.      Fido Compression Programs . . . . . . . . . . . . . .  27
  81.      Fido AreaFix Forwarding . . . . . . . . . . . . . . .  28
  82. WaterGate manual                                        [page ii]
  83.  
  84. Setting up the UUCP System . . . . . . . . . . . . . . . .  29
  85.      UUCP settings . . . . . . . . . . . . . . . . . . . .  29
  86.           The spool directory system . . . . . . . . . . .  29
  87.           UUCP name. . . . . . . . . . . . . . . . . . . .  30
  88.           Domain addresses . . . . . . . . . . . . . . . .  31
  89.           Smart host . . . . . . . . . . . . . . . . . . .  31
  90.           Backbone . . . . . . . . . . . . . . . . . . . .  32
  91.           Default groups . . . . . . . . . . . . . . . . .  32
  92.           Time zone. . . . . . . . . . . . . . . . . . . .  32
  93.           Maximum bundle size. . . . . . . . . . . . . . .  33
  94.           Undeliverable mail . . . . . . . . . . . . . . .  33
  95.           Bounce small . . . . . . . . . . . . . . . . . .  33
  96.      UUCP Compression Programs . . . . . . . . . . . . . .  34
  97.      UUCP newsfix forwarding . . . . . . . . . . . . . . .  35
  98.  
  99. Gateway Settings . . . . . . . . . . . . . . . . . . . . .  36
  100.      Gateway AKA . . . . . . . . . . . . . . . . . . . . .  36
  101.      Gateway User. . . . . . . . . . . . . . . . . . . . .  36
  102.      Gateway TO. . . . . . . . . . . . . . . . . . . . . .  37
  103.      Kill gated netmail. . . . . . . . . . . . . . . . . .  37
  104.      FSC-35 kludges. . . . . . . . . . . . . . . . . . . .  37
  105.      Fido From:. . . . . . . . . . . . . . . . . . . . . .  37
  106.      Copy Headers. . . . . . . . . . . . . . . . . . . . .  38
  107.      ASCII conversion. . . . . . . . . . . . . . . . . . .  39
  108.      Name separator. . . . . . . . . . . . . . . . . . . .  39
  109.      Small addresses . . . . . . . . . . . . . . . . . . .  40
  110.  
  111. Private mail settings. . . . . . . . . . . . . . . . . . .  41
  112.  
  113. Logfile settings . . . . . . . . . . . . . . . . . . . . .  42
  114.  
  115. Administrator. . . . . . . . . . . . . . . . . . . . . . .  43
  116.  
  117. Groups . . . . . . . . . . . . . . . . . . . . . . . . . .  44
  118.  
  119. Creating Areas . . . . . . . . . . . . . . . . . . . . . .  45
  120.      Area name . . . . . . . . . . . . . . . . . . . . . .  46
  121.      Comment . . . . . . . . . . . . . . . . . . . . . . .  46
  122.      Area type . . . . . . . . . . . . . . . . . . . . . .  47
  123.      In groups . . . . . . . . . . . . . . . . . . . . . .  47
  124.      Subscribers . . . . . . . . . . . . . . . . . . . . .  47
  125.      Allow passive . . . . . . . . . . . . . . . . . . . .  47
  126.      Passive . . . . . . . . . . . . . . . . . . . . . . .  48
  127.      Origin. . . . . . . . . . . . . . . . . . . . . . . .  48
  128.      Custom. . . . . . . . . . . . . . . . . . . . . . . .  48
  129.      Origin AKA. . . . . . . . . . . . . . . . . . . . . .  48
  130.      Add SEEN-BY . . . . . . . . . . . . . . . . . . . . .  48
  131.      Moderated and Moderator . . . . . . . . . . . . . . .  48
  132.      Fido base and path. . . . . . . . . . . . . . . . . .  49
  133.      Fido age and limit. . . . . . . . . . . . . . . . . .  49
  134.  
  135. Adding Users . . . . . . . . . . . . . . . . . . . . . . .  50
  136.      Fidonet style user. . . . . . . . . . . . . . . . . .  51
  137.           Organization . . . . . . . . . . . . . . . . . .  51
  138.           Allowed groups . . . . . . . . . . . . . . . . .  52
  139.           Subscribed to. . . . . . . . . . . . . . . . . .  52
  140. WaterGate manual                                        [page iii]
  141.  
  142.           Passive. . . . . . . . . . . . . . . . . . . . .  52
  143.           Address. . . . . . . . . . . . . . . . . . . . .  52
  144.           SysOp. . . . . . . . . . . . . . . . . . . . . .  53
  145.           Packet password. . . . . . . . . . . . . . . . .  53
  146.           AreaFix password . . . . . . . . . . . . . . . .  53
  147.           AreaFix special. . . . . . . . . . . . . . . . .  53
  148.           New Area-create. . . . . . . . . . . . . . . . .  53
  149.           Compression. . . . . . . . . . . . . . . . . . .  54
  150.           Send format. . . . . . . . . . . . . . . . . . .  54
  151.           Max PKT length . . . . . . . . . . . . . . . . .  54
  152.           UUCP name. . . . . . . . . . . . . . . . . . . .  54
  153.           Domain addresses . . . . . . . . . . . . . . . .  55
  154.           World Registered . . . . . . . . . . . . . . . .  55
  155.           Allow sub-domains. . . . . . . . . . . . . . . .  55
  156.      UUCP style user . . . . . . . . . . . . . . . . . . .  56
  157.           Remark on the use of "New Area-create" . . . . .  57
  158.      Bag supplier. . . . . . . . . . . . . . . . . . . . .  58
  159.           Return system. . . . . . . . . . . . . . . . . .  58
  160.           WARNING about the return system. . . . . . . . .  59
  161.  
  162. The List Server. . . . . . . . . . . . . . . . . . . . . .  60
  163.      Subscribing to a mailing list . . . . . . . . . . . .  60
  164.      Setting up a mailing list . . . . . . . . . . . . . .  61
  165.           List name. . . . . . . . . . . . . . . . . . . .  62
  166.           Description. . . . . . . . . . . . . . . . . . .  62
  167.           Welcome file . . . . . . . . . . . . . . . . . .  62
  168.           Private list . . . . . . . . . . . . . . . . . .  63
  169.           Only known . . . . . . . . . . . . . . . . . . .  63
  170.           Active . . . . . . . . . . . . . . . . . . . . .  63
  171.           AKA. . . . . . . . . . . . . . . . . . . . . . .  63
  172.           Area name. . . . . . . . . . . . . . . . . . . .  64
  173.           Echo to list . . . . . . . . . . . . . . . . . .  64
  174.           List to echo . . . . . . . . . . . . . . . . . .  64
  175.           Subscribers. . . . . . . . . . . . . . . . . . .  64
  176.      Forwarding a mailing list you receive into an area. .  64
  177.  
  178. The Gateway. . . . . . . . . . . . . . . . . . . . . . . .  66
  179.      The echomail<->news gateway . . . . . . . . . . . . .  66
  180.           Gating echomail to news. . . . . . . . . . . . .  66
  181.           Gating news to echomail. . . . . . . . . . . . .  66
  182.      The netmail<->mail gateway. . . . . . . . . . . . . .  67
  183.           Using the gateway with netmail . . . . . . . . .  67
  184.           Fidonet address to e-mail address translation. .  68
  185.           Creating UUCP message headers in the netmail . .  72
  186.           Using the gateway with mail. . . . . . . . . . .  74
  187.  
  188. The ROUTE.TDB file and its options . . . . . . . . . . . .  75
  189.      ROUTE-FIDO: Route Fido messages . . . . . . . . . . .  76
  190.      ROUTE-UUCP: Route UUCP messages . . . . . . . . . . .  77
  191.           About bangpaths. . . . . . . . . . . . . . . . .  79
  192.           Routing things you cannot do in ROUTE.TDB. . . .  79
  193.           A few last remarks about UUCP routing. . . . . .  80
  194.      MAP-FIDO: Mapping fido netmail messages . . . . . . .  81
  195.           Order of precedence for MAP-FIDO . . . . . . . .  81
  196.      MAP-UUCP: Mapping UUCP mail messages. . . . . . . . .  82
  197.           Order of precedence for MAP-UUCP . . . . . . . .  83
  198. WaterGate manual                                        [page iv]
  199.  
  200.      FORBID-FIDO/ALLOW-FIDO: Restricting the gateway . . .  83
  201.      MAP-AREA: Receive a mailing list in a message base. .  84
  202.      SIGNATURE: Adding signatures to a message . . . . . .  85
  203.      NEWSFILTER: Auto-created newsgroups filter. . . . . .  87
  204.           Logging information. . . . . . . . . . . . . . .  88
  205.      SENDFILE: a simple file robot . . . . . . . . . . . .  88
  206.      BOUNCE: Send mail back with a reason. . . . . . . . .  89
  207.      SAVE: Write messages to disk. . . . . . . . . . . . .  89
  208.      MAP-UUCP and BOUNCE, SAVE, SENDFILE . . . . . . . . .  90
  209.      GZIPBATCH . . . . . . . . . . . . . . . . . . . . . .  90
  210.      NOSLICE . . . . . . . . . . . . . . . . . . . . . . .  90
  211.  
  212. Using AreaFix / newsfix. . . . . . . . . . . . . . . . . .  91
  213.  
  214. Installing the DPMI version. . . . . . . . . . . . . . . .  93
  215.      Swap memory versus DPMI . . . . . . . . . . . . . . .  93
  216.      Swapfile on a RAM-disk. . . . . . . . . . . . . . . .  94
  217.      Maximum number of file handles. . . . . . . . . . . .  94
  218.  
  219. Customizing messages . . . . . . . . . . . . . . . . . . .  95
  220.      The language file . . . . . . . . . . . . . . . . . .  95
  221.      The text files. . . . . . . . . . . . . . . . . . . .  95
  222.      Filenames . . . . . . . . . . . . . . . . . . . . . .  96
  223.      Tokens. . . . . . . . . . . . . . . . . . . . . . . .  97
  224.  
  225. Using a secondary tosser . . . . . . . . . . . . . . . . .  98
  226.  
  227. Statistical information. . . . . . . . . . . . . . . . . .  99
  228.      Format of the WTRGATE.STA file. . . . . . . . . . . .  99
  229.      The WtrStat program . . . . . . . . . . . . . . . .   100
  230.      Possible graphs . . . . . . . . . . . . . . . . . .   100
  231.      Command line options. . . . . . . . . . . . . . . .   101
  232.  
  233. Translating from other programs. . . . . . . . . . . . .   102
  234.      Adding information from Gecho v1.02 . . . . . . . .   102
  235.      Adding information from Waffle. . . . . . . . . . .   102
  236.      Adding Information from Squish. . . . . . . . . . .   103
  237.  
  238. Commandline parameters . . . . . . . . . . . . . . . . .   104
  239.      WTRGATE.EXE . . . . . . . . . . . . . . . . . . . .   104
  240.      WTRCONF.EXE . . . . . . . . . . . . . . . . . . . .   105
  241.      WTRUTIL.EXE . . . . . . . . . . . . . . . . . . . .   105
  242.           Groups filter option . . . . . . . . . . . . .   107
  243.      WTRSTAT.EXE . . . . . . . . . . . . . . . . . . . .   108
  244.  
  245. Appendixes . . . . . . . . . . . . . . . . . . . . . . .   109
  246.      Appendix A: Message Bases . . . . . . . . . . . . .   109
  247.           Fido *.MSG . . . . . . . . . . . . . . . . . .   109
  248.           Squish . . . . . . . . . . . . . . . . . . . .   109
  249.           JAM. . . . . . . . . . . . . . . . . . . . . .   110
  250.      Appendix B: Error codes . . . . . . . . . . . . . .   112
  251.      Appendix C: TradeMarks. . . . . . . . . . . . . . .   113
  252. WaterGate manual                                        [page 1]
  253.  
  254. Introduction
  255. ------------
  256.  
  257. WaterGate is a message processing system. It can handle
  258. netmail and echomail in Fidonet Technology (FTN) format and
  259. Internet e-mail and Usenet news in UUCP format. It can
  260. distribute and gate the messages from and two the formats
  261. supported. It works by processing files and is thus not
  262. capable of transferring files.
  263.  
  264. Speaking in Fidonet terminology, it is a tosser that can
  265. handle Internet and Usenet as well.
  266.  
  267. As far as Internet and Usenet are concerned, WaterGate can
  268. only process files that have been transferred using the UUCP
  269. protocol. There is no support for SLIP or PPP connections or
  270. SMTP and NNTP protocols. We intend to support this in the
  271. future though.
  272.  
  273. The terms Fidonet and UUCP will be used to differentiate
  274. between the two systems. Fidonet refers to both netmail and
  275. echomail, where UUCP refers to both Internet e-mail and Usenet
  276. news.
  277.  
  278. Features
  279.  
  280.    - Fidonet message processing: netmail and echomail
  281.    - Internet/Usenet message processing: e-mail and news
  282.    - Gateway between Fidonet and Usenet
  283.    - Supports 65,000+ areas and nodes
  284.    - Support for *.MSG, Squish, and JAM message bases
  285.    - Built-in Remote Area Manager for Fidonet and Usenet(!)
  286.    - Utility program to perform messagebase maintenance
  287.    - Built-in Mailing List Server
  288.    - Built-in File Robot
  289.    - Configuration program with friendly user interface
  290.    - Context sensitive online help "everywhere"
  291.    - The fastest, most complete and most user friendly around!
  292.  
  293. Compatible with
  294.  
  295.    - FrontDoor/InterMail
  296.    - BinkleyTerm/TIMS
  297.    - d'Bridge
  298.    - Waffle's UUCICO/FX-UUCICO
  299.  
  300. Requirements
  301.  
  302.    - An IBM Compatible computer (XT/AT/386/486/Pentium)
  303.    - MS-DOS, OS/2, Windows '95, Windows NT or compatible
  304.      Operating System
  305.    - At least 500Kb of available memory
  306.    - Optionally some XMS/EMS memory
  307.    - Enough hard disk space depending on your configuration
  308. WaterGate manual                                        [page 2]
  309.  
  310. To operate effectively, you probably need a Fidonet compatible
  311. mailer such as FrontDoor or BinkleyTerm. Also, if you want to
  312. exchange mail with a the UUCP mechanism, a program such as
  313. UUCICO or the faster FX-UUCICO is needed. These programs
  314. should be available on any large BBS or FTP site.
  315.  
  316.  
  317. We would like to thank the following users for testing the
  318. beta versions of WaterGate, finding bugs, sending problem
  319. reports and test files, and making suggestions for
  320. improvements:
  321.  
  322. Miguel Lupi Alves, Mitchell Baker, Anthony Barlow, Gerrit
  323. Brinkman, Glen Chambers, Thomas Charron, Troy Engel, Richard
  324. Fairhead, Sue Fairhead, Frans van Geene, Guus Goos,
  325. Christopher Henderson, John Halbig, Erik Kolodziej, Phill
  326. McKenna, Jim Meijer, Steve Milstead, Bob Ross, Robert Stark,
  327. Peter van der Steen, Joop Stokvis, Rob Szarka, Pat Trainor,
  328. Michel Voorn, Rene Vreeman, Remco Vrolijk, Rob Waite, Jurgen
  329. van der Wilk
  330.  
  331. and anybody else who we forgot to mention!
  332.  
  333. Explicite NO thanks to Jon Greaves and Colin Taylor for
  334. disappearing as credit card sites, without telling us.
  335. WaterGate manual                                        [page 3]
  336.  
  337. Welcome to WaterGate,
  338.  
  339. The demand for electronic mail is increasing daily, as is the
  340. number of people reading and writing electronic messages.
  341. There is Fidonet, connecting thousands of Bulletin Board
  342. Systems and their users on all continents, and there is
  343. Internet, to which almost every university and major company
  344. has a connection. Then there are numerous other networks,
  345. using technology similar to the ones mentioned.
  346.  
  347. WaterGate is a mail processing program capable of processing
  348. both messages that were created by a Fidonet Technology
  349. compatible program, and messages created by a program that
  350. supports RFC822, the protocol widely used within Internet for
  351. e-mail. Finally, it supports a variant to the RFC822 protocol
  352. that is used for the over 10000 newgroups within Internet,
  353. also known as Usenet.
  354.  
  355. From now on, the term UUCP will be used for both Internet e-
  356. mail and Usenet news, just like Fidonet refers to both netmail
  357. and echomail.
  358.  
  359. WaterGate was written to simplify the process of connecting
  360. both Fidonet and UUCP compatible systems by integrating the
  361. four steps needed to build a Fidonet/UUCP message host:
  362.  
  363.   1) Process and distribute UUCP messages, for us and other
  364.      systems.
  365.  
  366.   2) Process and distribute Fidonet messages, for us and other
  367.      systems.
  368.  
  369.   3) Translate (gate) messages between the two formats.
  370.  
  371.   4) Import either style message into message bases.
  372.  
  373. So, no matter if you are a Fido point, node, hub, zonegate, or
  374. UUCP node or hub, WaterGate is the program to use for
  375. processing all your netmail, echomail, mail and news.
  376.  
  377. In addition to that, it is loaded with tools and features like
  378. AreaFix for both Fidonet and UUCP(!!), mailing list server,
  379. read-only areas, file robot and options to import data from
  380. your previously favorite programs. We plan to support other
  381. transport mechanisms and mailers in future as well. It was
  382. designed to do this.
  383.  
  384. We hope WaterGate achieves its design goals: ease of
  385. configuration of both WaterGate and your complete mail
  386. processing system, speed of operation, computability, and
  387. stability.
  388.  
  389. The authors
  390. WaterGate manual                                        [page 4]
  391.  
  392. Contacting the authors
  393. ----------------------
  394.  
  395. The authors can be contacted at the following addresses:
  396.  
  397. Ramon van der Winkel  
  398.      Internet: ramon@wsd.wline.se
  399.  
  400. Martijn Dijksterhuis
  401.      Fido: 2:280/802.6@fidonet.org
  402.      Internet: martijnd@htsa.hva.nl
  403.  
  404. Michel van der Laan
  405.      Internet: michel@nijenrode.nl
  406.  
  407. Support site, newsgroup and the mailing list
  408. --------------------------------------------
  409.  
  410. The wsd (Waterline Software Development) system at
  411. wsd.wline.se is our support site, operated by Ramon van der
  412. Winkel. Mail your problems and requests to ramon@wsd.wline.se.
  413. The latest patches are always requestable from our file robot.
  414. Send a message to watergate-info@wsd.wline.se to get a text
  415. file with a description of all the files you can request.
  416.  
  417. There is also a newsgroup: ALT.BBS.WATERGATE.
  418. Unfortunately, there are some distribution problems, apart for
  419. the continuous spam postings. Everything seems to work
  420. properly from the USA side, but posting in europe doesn't make
  421. it far.
  422.  
  423. Finally, there is the WaterGate mailing list. To subscribe,
  424. write a message to listserv@wsd.wline.se and put the following
  425. command in the body of the message: "connect watergate"
  426. (without the quotes). After the reply from the listserver, you
  427. can send your problems to watergate@wsd.wline.se to have them
  428. distributed to everybody else that is connected to the mailing
  429. list. The main use of the mailing list is for annoucements by
  430. the authors.
  431. WaterGate manual                                        [page 5]
  432.  
  433. Disclaimer, legal stuff, license, money and you!
  434. ------------------------------------------------
  435.  
  436. "WaterGate" refers to all executables and documentation
  437. included in the package that was released.
  438.  
  439. WaterGate is (c) Copyrighted material by WaterLine Software
  440. Development V.O.F. in The Netherlands. By using this software
  441. you accept the terms of the license agreement stated below.
  442.  
  443.    - WaterGate is released as Shareware, you may use the
  444.      unregistered version of this program for a trial period
  445.      of thirty (30) days. After this period you MUST either
  446.      register WaterGate or stop using it.
  447.  
  448.    - WaterGate is provided 'as is', without warranty of any
  449.      kind, neither expressed nor implied. Waterline Software
  450.      Development only guarantees that WaterGate will occupy
  451.      disk space.
  452.  
  453.    - In no event is Waterline Software Development liable to
  454.      you or anyone else for any damages, including lost
  455.      profits, lost savings or other incidental or
  456.      consequential damages arising out of the use of
  457.      WaterGate.
  458.  
  459.    - In no way is Waterline Software Development obliged to
  460.      you or anyone else to provide future versions of
  461.      WaterGate.
  462.  
  463.    - All mentioned products and packages are copyrighted by
  464.      and trademarks of their respective holders. If you are
  465.      using WaterGate in a Non-Commercial environment refer to
  466.      the REGSITES.DOC file for information on how to register.
  467.      Commercial users have to contact the authors for more
  468.      information.
  469.  
  470. A Commercial environment is any of the following:
  471.  
  472.    - Business          - Government
  473.    - Organization      - Foundation
  474.    - School            - Any other form of juridical person
  475.    - Any form of system where WaterGate is used to make a
  476.      profit, direct or indirect.
  477.  
  478. Remember that WaterGate is currently in a BETA phase. This
  479. means it needs extensive testing by YOU! Most parts of it are
  480. currently used by a number of larger sites, but this doesn't
  481. mean it is trouble-free all through! Stay up to date with the
  482. latest release. We try to release a new version at least every
  483. two months, so read ALT.BBS.WATERGATE or connect to the
  484. mailing list for release announcements.
  485.  
  486. Please do support the Shareware concept.
  487. WaterGate manual                                        [page 6]
  488.  
  489. Installing WaterGate
  490. --------------------
  491.  
  492. Before you go through the step-by-step installation, please
  493. read this chapter first. After reading it, you will know about
  494. the basic issues that are involved with WaterGate and
  495. understand the big picture when installing the smaller parts.
  496.  
  497. Program description
  498. -------------------
  499.  
  500. WaterGate supports the Fidonet and UUCP technologies.
  501. Throughout this chapter we will assume you need support for
  502. both of them. You can see them as two separate flows of
  503. messages that only touch when messages are going through the
  504. gateway. Have a look at the following two pictures that
  505. describe the distribution abilities of WaterGate.
  506.  
  507. The distribution system:
  508.  
  509.     +------+   +---------+   +-------+   +--------------+  
  510.     | UUCP |   |satellite|   |Fidonet|   |optional other|  
  511.     |uplink|   |receiver |   |uplink |   |Fidonet uplink|  
  512.     +--+---+   +----+----+   +---+---+   +------+-------+  
  513.        |           \|/           |              | 
  514.   +----+------------+------------+--------------+-----------+
  515.   |                W  A  T  E  R  G  A  T  E                |
  516.   +--+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+---+------+
  517.      | | | | | | | | | | | | | | | | | | | | | | |   |
  518.      U P P P N P U P N P P P N U P P U U U U U U P   |
  519.                                                +-----+-------+
  520.   U = UUCP-style user                          |local system |
  521.   N = Fidonet-style node                       |message bases|
  522.   P = Fidonet-style point                      |like BBS     |
  523.                                                +-------------+
  524.  
  525. The pictures shows a few systems that provide the big message
  526. traffic to you. The satellite receiver is optional, of course,
  527. but is put here because WaterGate supports it. Whereas you can
  528. be in more than one network with the Fidonet technology, there
  529. is only one Internet and thus you have only one UUCP uplink.
  530.  
  531. On the bottom side you see the systems that receive their
  532. messages from your system. WaterGate allows Fidonet style
  533. systems to receive UUCP messages and vice versa. The messages
  534. can also be imported into a message base for your BBS, or for
  535. you to read.
  536.  
  537. Don't worry if your system is not as big as in the picture
  538. above. You can use WaterGate as well if you are `just' a
  539. Fidonet style node or point, with possibly a UUCP feed as
  540. well.
  541. WaterGate manual                                        [page 7]
  542.  
  543. The next picture shows what WaterGate does to provide the
  544. interchangeability of the messages between UUCP and Fidonet.
  545. The top and bottom bars are the UUCP and Fidonet message flows
  546. respectively and in the middle is the WaterGate program.
  547.  
  548. The gateway system:
  549.  
  550.   ------------------------- - - - -------------------------
  551.    mail                      UUCP                     news
  552.   -----+--------+-------+-- - - - ---+------+---------+----
  553.        |        |       |            |      |         |
  554.    +---+---+ +--+----+ ++------------++ +---+---+ +---+---+
  555.    |newsfix| | mail  | | mailinglists | | news  | |message|
  556.    |AreaFix| |gateway| |    server    | |gateway| | bases |
  557.    +---+---+ +--+----+ ++------------++ +---+---+ +---+---+
  558.        |        |       |            |      |         |
  559.   -----+--------+-------+- - - - - - +------+---------+----
  560.    netmail                 Fidonet                echomail
  561.   ------------------------ - - - - - ----------------------
  562.  
  563. The internal parts of WaterGate can be divided into the parts
  564. described above. It can process mail, news, netmail, and
  565. echomail to and from UUCP and Fidonet.
  566.  
  567. If it is necessary for a mail or netmail message to go to the
  568. other network, it goes through the mail gateway. There is a
  569. different gateway for the news, but that one is almost
  570. invisible to the users. The mail gateway can be addressed from
  571. both networks.
  572.  
  573. News flows in newsgroups, and echomail flows in echoes. Inside
  574. WaterGate we simply call them areas. To connect and disconnect
  575. areas, the users have to write a netmail or mail message to
  576. AreaFix so the system operator (that's you) doesn't have to do
  577. all that work manually.
  578.  
  579. On the far right side of the picture are the message bases.
  580. Every message that flows through an area can be imported into
  581. a message base as well. WaterGate supports the *.MSG, Squish,
  582. and JAM message base formats. In fact, there is also a netmail
  583. messagebase (not shown in the drawing).
  584.  
  585. The big box in the middle of the picture is not WaterGate's
  586. heart, but is the mailing list server. A mailing list is like
  587. a private newsgroup. If a message is sent to a mailing list,
  588. all users connected to that list receive the message by mail
  589. or netmail. So, the mailing list is just a list of receiver
  590. addresses. It is also possible to connect the mailing list to
  591. an area so you can connect a newsgroup or echo, but that is
  592. mainly intended to import the messages into a messagebase.
  593. This explains why the box in the middle of the drawing has so
  594. many connections.
  595. WaterGate manual                                        [page 8]
  596.  
  597. UUCP for beginners
  598. ------------------
  599.  
  600. There are a lot "Fidonet people" that want to connect the the
  601. Internet and receive e-mail and news. The "Internet related"
  602. terms used in WaterGate are not always familiar to them. This
  603. short chapter therefore explains how the "other" system works.
  604.  
  605. About UUCP
  606. ----------
  607.  
  608. To receive mail and news and process it with WaterGate, you
  609. need a UUCP connection to an Internet Provider. These
  610. providers mostly sell PPP and SLIP connections and give you an
  611. account to login and a mailbox. After connecting to them and
  612. using special software, you can read your e-mail.
  613.  
  614. The problem with these links is that you only have one mailbox
  615. and thus one e-mail address. WaterGate was made to handle
  616. loads of e-mail addresses, sub-systems (downlinks), so you
  617. need a UUCP connection instead.
  618.  
  619. Once you have this connecting, your provider will store all
  620. news you want to receive and all e-mail for your systems and
  621. your downlink systems. When you connect to them, you pick up
  622. all this mail and news using the UUCP protocol.
  623.  
  624. WaterGate cannot do this for you. WaterGate is a tosser and
  625. not a mailer. You need a program like Waffle's UUCICO or the
  626. FX-UUCICO program to send and receive your UUCP "batches" as
  627. they are called.
  628.  
  629. Spool directory
  630. ---------------
  631.  
  632. These batches are stored in your "spool directory", which is a
  633. subdirectory on your harddisk, for example C:\SPOOL\. Your
  634. UUCP uplink system has a sub-directory there, as well as your
  635. UUCP style downlink systems. Not your Fidonet style downlink
  636. systems, they have the inbound and outbound directories.
  637.  
  638. In these spool directories you will find files with the names
  639. *.X, *.D, *.XQT, *.DAT and *.CMD. The first two are incoming
  640. (inbound, received) files. WaterGate processes these files.
  641. The last three are outgoing (outbound, to be sent) files. The
  642. XQT file will end up on the other system's harddisk like a .X
  643. file and the .DAT file as a .D file. The .CMD file is used by
  644. the UUCICO (UUCP mailer) program and tells it which files to
  645. transfer.
  646.  
  647. The .X file is the so called "envelope" file and the .D file
  648. the letter itself. Each e-mail file has a .X file in which
  649. WaterGate finds the e-mail address of the recipient and a
  650. reference to the .D file, amongst others. In case of news, the
  651. .X file contains the recipient name "rnews".
  652. WaterGate manual                                        [page 9]
  653.  
  654. Each e-mail message has its own .X and .D file. The news is
  655. bundled and you will find one .X file for each .D file with a
  656. number of news message in it. The .D file is mostly limited by
  657. size, not by number of news messages.
  658.  
  659. Compressed news and batch headers
  660. ---------------------------------
  661.  
  662. To reduce the transfer time, news batches are mostly
  663. compressed. E-mail is never compressed. There are two forms of
  664. compression used with UUCP: the older 12-bit or 16-bit
  665. "compress" and the nowadays more common "gzip".
  666.  
  667. Because of this compression, you cannot read the .D files with
  668. news directory. You have to decompress them first.
  669.  
  670. To make it easier for a script-based UNIX machine to detect
  671. the compression format, a special "batch header" is added to
  672. the start of the compressed file. When the file is compressed
  673. with normal compress, you will find the header "#! cunbatch"
  674. there. When it is compressed with gzip you will find the
  675. header "#! gunbatch" or "#! zunbatch" there.
  676.  
  677. WaterGate automatically detects all these headers and
  678. compressed formats and decompressed the .D files.
  679.  
  680. UUCP Name and Domain addresses
  681. ------------------------------
  682.  
  683. There are two key issues involved in addressing in the
  684. Internet world: UUCP name and domain address.
  685.  
  686. The "UUCP name" is the is a name of maximum 12 characters that
  687. identifies your system from your neighbours. The more
  688. important "domain address" identifies your system world-wide.
  689. My UUCPname is "wsd" and my domain address is "wsd.wline.se".
  690.  
  691. When you want to create UUCP downlinks, you have to give them
  692. an (for your system) unique UUCP name. You only almost never
  693. have to give Fido downlinks a UUCP name.
  694.  
  695. Your e-mail address is always <username>@<domain address>, for
  696. example "ramon@wsd.wline.se", where the part before the @ is
  697. called "user name".
  698. WaterGate manual                                        [page 10]
  699.  
  700. WaterGate terminology
  701. ---------------------
  702.  
  703. To configure the WaterGate system, you have to use the WtrConf
  704. program. Inside this program you can create the areas, mailing
  705. lists, receiving users, and uplink systems. Note that the
  706. latter two are logically the same for WaterGate.
  707.  
  708. A message that is received from a user is sent to all other
  709. users connected to that same area, no matter if that user is
  710. an uplink system or not. Read that again, because all
  711. WaterGate does is based on this!
  712.  
  713. You also use the WtrConf program to configure all the other
  714. system related items. An exception is the ROUTE.TDB ASCII
  715. configuration file that contains the routing information,
  716. mapping commands, and gateway restrictions. You don't need
  717. this file right away when you start to set up your system.
  718. Most of these items will be moved into the WtrConf program
  719. some day.
  720.  
  721. Groups
  722. ------
  723.  
  724. WaterGate allows you to separate the areas from the different
  725. networks into 26 groups. An area has to be in at least one
  726. group, but can also be in more than one group. That way you
  727. can give one or more users access to a certain group in which
  728. they can only connect to some of the areas you have. You can
  729. also easily divide the UUCP and Fidonet networks into groups.
  730. And it is also possible to make a group read-only so that
  731. users subscribing to areas in that group cannot post messages
  732. in it, but only receive messages from it.
  733.  
  734. If a message is received in an area that is not defined in
  735. your system, you can have WaterGate create that area
  736. automatically (and optionally a message base as well). You can
  737. enable this for your uplinks and save yourself a lot of typing
  738. work.
  739. WaterGate manual                                        [page 11]
  740.  
  741. User types
  742. ----------
  743.  
  744. There are a few different user types that you have to be aware
  745. of before you start creating users. The big difference between
  746. the users is the way they communicate with your system: with
  747. the UUCP protocol or in FTN (Fidonet) packets. Aside from
  748. that, you can assign UUCP addresses to Fidonet users. That
  749. way, a user with Fidonet address 2:280/802 can have an
  750. Internet domain address like bbsw.wlink.nl. If a user on that
  751. system sends a message to Internet, his address will be a nice
  752. Internet address instead of something like
  753. user@f802.n280.z2.wlink.nl.
  754.  
  755. Resuming, there are plain UUCP users and plain Fidonet users,
  756. but you can extend the Fidonet users by filling in some of the
  757. fields to 'upgrade' them and allow transparant access to
  758. Internet and Usenet, just like a UUCP user.
  759.  
  760. Apart from giving systems a nice domain address, you can also
  761. assign nice name to Fidonet users for sending messages into
  762. the Internet. The user Martijn Dijksterhuis at 2:280/802.6 can
  763. be given the nice name and address martijnd@dijkline.wlink.nl
  764. using a mapping statement.
  765.  
  766. The last thing you have to do before you start setting up the
  767. system is think about the addresses and names the system will
  768. be known as. This is very important, because a lot of errors
  769. are made with the assignment of addresses. Try to write down
  770. the addresses of your uplink(s), the addresses and names of
  771. your WaterGate system, and some of the addresses of your
  772. downlinks (users). This will make it a lot easier to configure
  773. the system.
  774.  
  775. Note that users who receive UUCP and Fidonet messages need not
  776. be defined twice in the userbase, but if the same user
  777. receives messages from two different Fidonet networks, you do
  778. have to define him/her under both addresses in the userbase.
  779.  
  780. An exception to this can be made for points. You can freely
  781. mix networks and assign only one address to them. WaterGate
  782. will make sure the nets are kept separated. You can't do this
  783. with nodes, because the messages, SEEN-BY lines, and PATH
  784. lines will then contain invalid node numbers for that network!
  785. WaterGate manual                                        [page 12]
  786.  
  787. Step by step installation
  788. -------------------------
  789.  
  790. The following pages describe the installation of WaterGate by
  791. going through all the possible entries in WtrConf. After that,
  792. we assume that you have become familiar with the system and
  793. explain several complete installations. This chapter will also
  794. teach you to use the user interface.
  795.  
  796. During this documentation, the term WaterGate refers to the
  797. entire package and the terms WtrGate, WtrConf and WtrUtil
  798. refer to separate programs of this package.
  799.  
  800. To start, unpack the archive containing the program files into
  801. a new directory on your harddisk, for example C:\WTRGATE. At
  802. least the following three executables should be present in the
  803. archive:
  804.  
  805.      WTRGATE.EXE
  806.      WTRCONF.EXE
  807.      WTRUTIL.EXE
  808.  
  809. You might want to set a environment variable called WTRGATE to
  810. this directory so WaterGate knows where to find its
  811. configuration files when not started from its home directory.
  812. Add this line to your autoexec.bat file:
  813.  
  814.      SET WTRGATE=C:\WTRGATE
  815.  
  816. Then run the configuration program, WtrConf, to create new
  817. configuration and database files. If you don't run it from the
  818. installation directory, make sure the WTRGATE environment
  819. variable is set, as indicated above. You might want to reboot
  820. or set it manually before continuing.
  821.  
  822. You don't need the DPMI version (in DPMI.ZIP) or the .TXT
  823. files (in DIJK_TXT.ZIP and RENE_TXT.ZIP) yet.
  824.  
  825. After starting WtrConf, you will see the following menu:
  826.  
  827.      +-------------------------+
  828.      |        Main Menu        |
  829.      +-------------------------+
  830.      | System configuration    |
  831.      | Area definitions        |
  832.      | User definitions        |
  833.      | List Server definitions |
  834.      | Group descriptions      |
  835.      | Import/export menu      |
  836.      | About WaterConf         |
  837.      | Exit program            |
  838.      +-------------------------+
  839.  
  840. You can select a menu line with the cursor keys up and down.
  841. To select one of the options, press enter. You can also exit a
  842. menu by pressing escape. In this case, pressing escape will
  843. present another menu, asking if you really want to quit the
  844. program. Select Yes and press enter to quit, or press escape
  845. WaterGate manual                                        [page 13]
  846.  
  847. again to return to the main menu. You can also exit the
  848. program by selecting the bottom menu option. To get there, use
  849. the cursor keys or press PgDn (page down).
  850.  
  851. To get back at the top of the menu, press PgUp (page up). You
  852. can also use the Home and End keys. You can always use
  853. function key F1 to get context sensitive help. Try pressing F1
  854. in the Main Menu.
  855.  
  856. To remove the help window, you have to press escape. It is
  857. sometimes possible to use special keys in the help screens,
  858. like PgUp and PgDn. The help screens will tell you when.
  859.  
  860. Last remark before we start. Have a look at the bottom line of
  861. the screen. It shows most of the keys you can use throughout
  862. the program and will change to reflect the keys you can use at
  863. a certain point.
  864.  
  865. We start with System Configuration, so select the top option
  866. from the Main Menu and press enter. You are now presented with
  867. a new menu, which looks like this:
  868.  
  869.      +---------------------------+
  870.      | System configuration menu |
  871.      +---------------------------+
  872.      | System settings           |
  873.      | Fido AKAs                 |
  874.      | Fido Settings             |
  875.      | Fido Messagebases         |
  876.      | Fido Compression programs |
  877.      | Fido AreaFix forwarding   |
  878.      | UUCP Settings             |
  879.      | UUCP Compression programs |
  880.      | UUCP newsfix forwarding   |
  881.      | Gateway Settings          |
  882.      | Private mail options      |
  883.      | Logfile settings          |
  884.      | Administrator settings    |
  885.      +---------------------------+
  886.  
  887. The System configuration menu is split into several parts,
  888. starting with general system settings, followed by five
  889. options that have to do with Fidonet settings, followed by
  890. three options for UUCP configuration settings. The last
  891. separate options are to setup the gateway and the private mail
  892. scanning system, to tune the logfile and to setup the
  893. administrator.
  894. WaterGate manual                                        [page 14]
  895.  
  896. System settings
  897. ---------------
  898.  
  899. Let's start with System settings. Press enter to get the
  900. screen:
  901.  
  902.      +-------------------------------------------+
  903.      | SysOp             Ramon van der Winkel    |
  904.      | System path       C:\WTRGATE\             |
  905.      | AreaFix name      AreaFix                 |
  906.      | Newsfix name      newsfix                 |
  907.      | Dupe checking     OFF on                  |
  908.      | Dupe checks       10000                   |
  909.      | Max. open handles 8                       |
  910.      | Cache .TDB files  OFF on                  |
  911.      | Oversized path    C:\WTRGATE\TOOBIG\      |
  912.      | Log file path     C:\WTRGATE\WTRGATE.LOG  |
  913.      | Use swap file?    off ON                  |
  914.      | Swap file path    C:\WTRGATE\WTRGATE.SWP  |
  915.      | Swap file size    2                       |
  916.      +-------------------------------------------+
  917.  
  918. This is a window with fields where you can enter data. You can
  919. use the cursor keys up and down to go through the fields.
  920. There are a number of different type of editing fields, but
  921. they all have one thing in common: press enter to edit the
  922. contents.
  923.  
  924. SysOp
  925. -----
  926.  
  927. The first field in this window is "SysOp". You have to put
  928. your name there. Since this is a text field, you can either
  929. press enter and edit its contents or you can start typing at
  930. once, without first pressing enter. This will clear the
  931. current contents of the field. So, press enter if you want to
  932. change its contents, or just start typing to completely
  933. replace its contents.
  934.  
  935. When editing a text field, you can always press escape to stop
  936. editing and restore the old contents. If you are satisfied
  937. with the new contents, you have to press the enter key to
  938. accept the changes. Inside the field, you can use the cursor
  939. keys left and right to move the cursor through the field. The
  940. backspace and delete keys work as expected. Insert mode is
  941. always on, though.
  942.  
  943. You can clear the contents of the field from the cursor
  944. position to the end of the field, by using the WordPerfect
  945. method: ctrl+end. To jump to the following or previous word,
  946. you can hold down the control key (ctrl) and use the cursor
  947. keys again. Finally, the home key brings you to the beginning
  948. of the field and the end key to the last character of the
  949. contents.
  950.  
  951. The SysOp field is used when WaterGate has to write special
  952. replies, for example for AreaFix. More about that later. Let's
  953. go to the next field.
  954. WaterGate manual                                        [page 15]
  955.  
  956. System path
  957. -----------
  958.  
  959. You have to enter the path to the WaterGate databases here, in
  960. our example C:\WTRGATE. This path information is stored in the
  961. WaterGate configuration database. It finds this database by
  962. looking at the environment variable WTRGATE. The path in this
  963. field will be used to find the other databases after having
  964. read the configuration file. So:
  965.  
  966.      WTRGATE=C:\WTRGATE -> 
  967.      WTRCFG.TDB -> 
  968.      System Path ->
  969.      The other *.TDB files
  970.  
  971. AreaFix and NewsFix
  972. -------------------
  973.  
  974. The next two fields are the names for AreaFix and newsfix,
  975. programs integrated in WTRGATE.EXE. A user can write a message
  976. to these programs to connect and disconnect areas and to
  977. change settings that are personal to that user. The names you
  978. enter in these fields are the names your users have to use
  979. when writing a message to them. AreaFix is used for Fidonet
  980. and newsfix is used for UUCP. It is conventional to use mixed
  981. case names for Fidonet ("AreaFix") and flat, lower case names
  982. for UUCP ("newsfix"). We will get back to these names later
  983. and assume you are using the default names, so there is no
  984. reason to change them here.
  985.  
  986. Duplicates
  987. ----------
  988.  
  989. On to the next two fields that have to do with dupe checking.
  990. WaterGate is able to identify two messages as being identical
  991. (duplicates) and then only distribute the first. This prevents
  992. wasting disk space and transport time.
  993.  
  994. At this moment, the method used to identify duplicates inside
  995. the WaterGate program is not very robust. We therefore advise
  996. big systems to disable duplicate checking until we have
  997. implemented a better algorithm. (At this moment, one database
  998. with a maximum of 16000 entries is used to keep track of all
  999. Fidonet and UUCP messages. No way is this enough for a system
  1000. receiving packets via satellite. Future algorithms will not
  1001. only separate Fido and UUCP dupes, but also do message/reply
  1002. id bridging and allow a bigger duplicates database).
  1003.  
  1004. The first field you can set for the duplicates checking is a
  1005. "toggle" field. Toggles are used to select from two or more
  1006. predefined options, in this case ON and OFF. You can only use
  1007. enter to toggle the setting. The one in upper case is the
  1008. current selection.
  1009. WaterGate manual                                        [page 16]
  1010.  
  1011. The next field is a numeric input field, where (in this case)
  1012. you can input the number of duplicates WaterGate has to
  1013. "remember". The number in our example window is 10000, which
  1014. means WaterGate will identify two duplicates, even if 9999
  1015. messages are sent in between. The maximum number you can enter
  1016. here is 16000.
  1017.  
  1018. When a duplicate message is found, it will be destroyed by
  1019. default. Later in the configuration, you can also create a
  1020. message base to put the duplicates in.
  1021.  
  1022. Max. open handles
  1023. -----------------
  1024.  
  1025. Because opening and closing a file takes a lot of time,
  1026. WaterGate tries keep an outgoing mail bundle open as long as
  1027. possible. If you allow it to use more file handles, you can
  1028. drastically reduce the number of open/close actions.
  1029.  
  1030. By default, WaterGate tries to open up to 8 handles for
  1031. outgoing mail packets. If you don't export mail to other
  1032. computers, then you can reduce this setting to 1. If you do
  1033. export mail, try increasing this number by 1 for each node.
  1034. WaterGate is capable of using up to 100 file handles. If you
  1035. have more nodes than handles, files are closed in a priority
  1036. order: the more mail a node receives, the less often its
  1037. packets are opened and closed.
  1038.  
  1039. Depending on its configuration, WaterGate needs up to 10 file
  1040. handles for its own use, the system will use a few too, so
  1041. make sure you have a matching number in your CONFIG.SYS:
  1042.  
  1043.      FILES=20+Nodes+10
  1044.  
  1045. Cache .TDB files
  1046. ----------------
  1047.  
  1048. WaterGate is able to copy its databases containing users and
  1049. areas into XMS memory, decreasing disk access during a run. To
  1050. activate this option, toggle "Cache .TDB files" to ON. 
  1051.  
  1052. At startup, WaterGate will copy its databases into XMS memory,
  1053. up to the amount of available memory. WaterGate has no other
  1054. use for XMS memory besides caching its databases and shelling.
  1055.  
  1056. Oversized path
  1057. --------------
  1058.  
  1059. When WaterGate encounters a message bigger than it can handle,
  1060. it will use the 'Oversized' path to store it for the SysOp to
  1061. look at. The maximum size of a message is limited by the
  1062. amount of free memory, which should be approximate 200
  1063. kilobytes.
  1064.  
  1065. If you use a swapfile (see below), WaterGate will only use the
  1066. oversized directory if the swapfile gets full as well.
  1067. WaterGate manual                                        [page 17]
  1068.  
  1069. Log file path
  1070. -------------
  1071.  
  1072. Use the 'Log file path' to specify a complete path and file
  1073. name for WaterGate's logfile. This file is used by both
  1074. WaterGate and WaterUtil to log run-time actions.
  1075.  
  1076. This path is also used to write the statistics file. This file
  1077. takes the same name as the log file, but with the extension
  1078. .STA. So, if your logfile is called WTRGATE.LOG, the
  1079. statistics log is named WTRGATE.STA and put in the same
  1080. directory as the logfile.
  1081.  
  1082. Use swap file?
  1083. --------------
  1084.  
  1085. WaterGate is able to use a swapfile as additional memory. If
  1086. it runs out of normal memory to store a message in, it will
  1087. swap all lines out of normal memory into the swapfile. This
  1088. frees up a lot of normal memory, allowing another couple of
  1089. thousand lines to be read again. If it fills up again, it
  1090. flushes these lines to the swapfile as well, and so on. You
  1091. can limit this by configuring a maximum swap file size.
  1092.  
  1093. Since WaterGate is not capable of using XMS memory to store
  1094. messages, you might be able to setup the swapfile on a RAM-
  1095. drive and let the RAM-drive use XMS memory. In this case,
  1096. though, the swapfile is limited by the available memory. It
  1097. may be better to put the swapfile on harddisk, so you can
  1098. process those 1 megabyte+ news and FTP-mail messages easily.
  1099.  
  1100. You can use the toggle 'Use swap file?' to switch the swapfile
  1101. usage on and off. It is on by default.
  1102.  
  1103. Swap file path
  1104. --------------
  1105.  
  1106. Since you might want to put the swap file on a RAM-drive, you
  1107. can enter the complete path plus filename for the swap file in
  1108. this field. WaterGate will create the file by itself and
  1109. delete it after running.
  1110.  
  1111. Swap file size
  1112. --------------
  1113.  
  1114. To set a maximum size for the swap file (you don't want it to
  1115. use up all of your harddisk space, do you?), you must enter a
  1116. limit in megabytes here. The default is 2 megabytes. WaterGate
  1117. will not use the space unless necessary. You can check the
  1118. swap file usage in the log file.
  1119.  
  1120. The main use for the limit is when putting the swapfile on a
  1121. RAM-drive. Depending on your mail configuration, between 1 and
  1122. 2 megabytes should be enough for the swapfile. Let us know if
  1123. you ever have to process bigger files (FTP-mail).
  1124. WaterGate manual                                        [page 18]
  1125.  
  1126. Setting up the Fido system
  1127. --------------------------
  1128.  
  1129. This part tells you in detail how to set up the fido side of
  1130. your WaterGate system. Other chapters will teach you how to
  1131. add users (uplinks, nodes, points, etc.) and areas (echomail
  1132. and netmail).
  1133.  
  1134. Fido AKAs
  1135. ---------
  1136.  
  1137. Because WaterGate needs to know who you are, enter the "Fido
  1138. AKAs" submenu from the "System Configuration" menu. Here you
  1139. can enter up to 20 different Fido addresses. The following
  1140. screen will be presented to you.
  1141.  
  1142.      + 20 ----------------------------+
  1143.      |           Fido AKAs            |
  1144.      +--------------------------------+
  1145.      ||2:280/803                 1017 |
  1146.      ||60:100/1                     0 |
  1147.      ||0                            0 |
  1148.      ||0                            0 |
  1149.      ||0                            0 |
  1150.      ||0                            0 |
  1151.      ||0                            0 |
  1152.      ||0                            0 |
  1153.      ||0                            0 |
  1154.      |v0                            0 |
  1155.      +--------------------------------+
  1156.  
  1157. We call these screens "Select Lists". They look very similar
  1158. to menus and the little difference is the number in the top
  1159. left corner of the window and the arrows on the line at the
  1160. left (it was changed to a "v" here). The number tells you how
  1161. many items are in the list. If there are more items in the
  1162. list than fit in the window, you can scroll through the list.
  1163. The arrows at the top and bottom of the line will tell you if
  1164. there are more items in a certain direction. Because you can
  1165. only see an arrow at the bottom of the line, we must be near
  1166. the top and there are more items below.
  1167.  
  1168. You can use a lot of keys to scroll through the list,
  1169. including the cursor keys Up, Down, PgUp, PgDn, Ctrl+PgUp, and
  1170. Ctrl+PgDn.
  1171.  
  1172. Some lists contain wider lines than fit in the window. In that
  1173. case, you can also scroll horizontally using the cursor keys
  1174. Left and Right and the Ctrl+Left, Ctrl+Right, Home, and End
  1175. keys. There will also be arrow indicators on these oversized
  1176. lines. We will get to some of these lists later. Let's get
  1177. back to the AKAs.
  1178.  
  1179. In this list you enter all the fido addresses (AKAs) this
  1180. system must be know as. Don't start typing all the AKAs at
  1181. once, but add some more as you configure more and more
  1182. networks.
  1183. WaterGate manual                                        [page 19]
  1184.  
  1185. The first AKA you enter here will be your main fido address.
  1186. Normally, the program will try to use a system AKA that
  1187. matches closely to the network it has to send a message to.
  1188. The main AKA is used when it is not possible to find a proper
  1189. match, or on other occasions, such as when the system has to
  1190. send a message to you, the SysOp.
  1191.  
  1192. Optionally, you can specify a Fakenet or Pointnet number. Only
  1193. use this if you have (or are) a point using old 3D Fidonet
  1194. software, which can't handle complete point addressing
  1195. directly.
  1196.  
  1197. For those of you who don■t know what a pointnet is: if a
  1198. mailer is incapable of handling 4D (zone:net/node.point)
  1199. addresses, but only 3D (zone:net/node) addresses, it would be
  1200. very inconvenient to have to use node numbers for your points
  1201. instead. Pointnets have been invented to solve this. A point
  1202. with an address 2:280/802.33 would then be translated to
  1203. 2:1017/33 if your pointnet for that AKA is 1017.
  1204.  
  1205. Note: if you want WaterGate to use the pointnet for a certain
  1206. point, you have to define that user in the userbase with the
  1207. pointnet address as his AKA. More on this later. Once again
  1208. back to the list.
  1209.  
  1210. The left side contains the AKA and the right side the pointnet
  1211. number. If you want to change a line, press Enter and you will
  1212. be presented a little (two line) window. You can change the
  1213. AKA at the top line and enter the pointnet number at the
  1214. bottom line.
  1215.  
  1216. Since WaterGate supports 5D addresses, you can enter your fido
  1217. AKA as zone:net/node.point@domain. The minimum is
  1218. zone:net/node, though.
  1219. WaterGate manual                                        [page 20]
  1220.  
  1221. Fido Settings
  1222. -------------
  1223.  
  1224. The next option from the System Settings menu brings you to a
  1225. screen like this:
  1226.  
  1227.      +-----------------------------------------------------+
  1228.      | Inbound dir 1     C:\INBOUND\                       |
  1229.      | Security          on OFF                            |
  1230.      |                                                     |
  1231.      | Inbound dir 2                                       |
  1232.      | Security          on OFF                            |
  1233.      |                                                     |
  1234.      | Outbound dir      E:\NODE\OUT\                      |
  1235.      |                                                     |
  1236.      | Origin 1          Life at the end of the impossible |
  1237.      | Origin 2                                            |
  1238.      | Fido System       binkley FrontDoor D'BRIDGE        |
  1239.      | D'bridge queue    E:\DBRIDGE\QUEUE\                 |
  1240.      | Rescan file       E:\DBRIDGE\DBRIDGE.RSN            |
  1241.      | Max *.MSG  length 12000                             |
  1242.      | Max Squish length 12000                             |
  1243.      | Max JAM    length 12000                             |
  1244.      | Max *.PKT  length 0                                 |
  1245.      | Default groups    A                                 |
  1246.      | Arcmail names     ARCMAIL hex all                   |
  1247.      +-----------------------------------------------------+
  1248.  
  1249. Inbound directories
  1250. -------------------
  1251.  
  1252. When Fidonet mail bundles arrive at your system, by use of a
  1253. Fido mailer such as FrontDoor or Binkley, they are put in a
  1254. special holding directory, also known as the "Inbound"
  1255. directory.
  1256.  
  1257. WaterGate supports up to two such directories. Each directory
  1258. has a switch to toggle security on or off. When security is ON
  1259. for an inbound directory, mail bundles are only decompressed
  1260. if they were sent by a system that is configured as a user on
  1261. our system. Second, decompressed mail bundles are checked to
  1262. ensure they contain the same password as defined for the user
  1263. sending the bundle. If no password is defined for a node, the
  1264. password within the mail bundle is ignored.
  1265.  
  1266. A mail bundle from an unknown node will be renamed to *.UNK
  1267. and logged. Mail bundles with a wrong password are renamed to
  1268. *.PWD and logged as well.
  1269.  
  1270. Outbound directory
  1271. ------------------
  1272.  
  1273. New mail bundles created for Fido style nodes that this node
  1274. sends mail to are put in the "Outbound" directory. For
  1275. BinkleyTerm systems, this is a Binkley 2.50 5D compatible
  1276. outbound directory, with support for Binkley point
  1277. directories.
  1278. WaterGate manual                                        [page 21]
  1279.  
  1280. WaterGate tries to create Binkley subdirectories when needed.
  1281. For FrontDoor systems, all outgoing mail bundles are stored in
  1282. this directory.
  1283.  
  1284. Since The TBBS mailer TIMS also uses the Binkley outbound
  1285. style directories, you can have WaterGate and TIMS operate on
  1286. the same directories as well. WaterGate does not _yet_ check
  1287. for TIMS busy files yet, nor does it create them. It does do
  1288. this for Binkley, though.
  1289.  
  1290. Just as TIMS and BinkleyTerm are almost the same, you can
  1291. select FrontDoor if you are using InterMail.
  1292.  
  1293. Warning: always make sure that WaterGate's primary system AKA
  1294. (the first one in the list) is also the primary AKA that the
  1295. mailer uses! If you fail to do so, the wrong users can get the
  1296. wrong archives!!
  1297.  
  1298. Origin lines
  1299. ------------
  1300.  
  1301. You can define up to two default Origin lines, which are
  1302. attached to messages exported from your local messagebases
  1303. without one, or when messages are converted from UUCP to
  1304. Fidonet. You can define a custom origin line for each area, or
  1305. choose to use one of these default lines.
  1306.  
  1307. Fido system
  1308. -----------
  1309.  
  1310. Choose the type of mailer you are using. Possible systems
  1311. include BinkleyTerm 2.50 and up, FrontDoor, and D'Bridge. All
  1312. three of these programs employ a different way to store
  1313. information on outgoing files. BinkleyTerm expects information
  1314. files in its outbound directories; FrontDoor uses the netmail
  1315. messages directory; and D'Bridge has a special queue path
  1316. where it looks for its information. If you are using D'Bridge,
  1317. specify that path in the "D'Bridge Queue" option.
  1318.  
  1319. Note that this selection changes WaterGate's behavior
  1320. drastically. Don't forget to set this switch properly, or you
  1321. will have a very hard time processing your inbound and
  1322. creating a proper and compatible outbound!
  1323.  
  1324. Rescan file
  1325. -----------
  1326.  
  1327. Your mailer will have to rescan its list of outgoing files and
  1328. messages after new mail has been set ready by WaterGate. To
  1329. inform the mailer of this, WaterGate can create or 'touch' a
  1330. special flag file. All you have to do is enter the proper path
  1331. plus filename. The following files are used for the different
  1332. systems:
  1333.  
  1334.      d'Bridge       DBRIDGE.RSN
  1335.      FrontDoor      FDRESCAN.NOW
  1336.      InterMail      IMRESCAN.NOW
  1337. WaterGate manual                                        [page 22]
  1338.  
  1339. Max length settings
  1340. -------------------
  1341.  
  1342. Because old Fido mail processors have trouble processing
  1343. messages over 12Kb in size, WaterGate can split messages that
  1344. exceed some maximum message length. Set this limit using the
  1345. "Max *.MSG length" option. This limit is used to split
  1346. messages when importing into the *.MSG messagebase and when
  1347. exporting to a .PKT file!
  1348.  
  1349. Although both the Squish and JAM specifications allow for
  1350. unlimited message sizes, most editors have trouble reading
  1351. messages that are over 64Kb in size. If you want WaterGate to
  1352. split the messages when importing them, enter a maximum
  1353. message size, or use 0 to ignore the message size and disable
  1354. message splitting.
  1355.  
  1356. Note: These are approximate values. WaterGate checks them
  1357. after having added a line of text, so there might be a slight
  1358. deviation in the final message size.
  1359.  
  1360. When packing outgoing messages for other nodes, WaterGate will
  1361. group them in .PKT files. You can specify a maximum size for
  1362. those .PKT (Max *.PKT length) files before WaterGate creates a
  1363. new one. During buildup, these .PKT files are named *.QQQ. At
  1364. the end of the run they are renamed to .PKT one at a time and
  1365. then added to the final archive.
  1366.  
  1367. Default groups
  1368. --------------
  1369.  
  1370. You can give each node access to a number of groups. You will
  1371. soon decide which groups will contain the echomail areas and
  1372. which will not.
  1373.  
  1374. When creating a new fido style user, you have to set the
  1375. groups he or she is allowed to access. Because you don't want
  1376. to set these every time, you can enter a default list of
  1377. groups in this screen.
  1378.  
  1379. After pressing enter, you are presented with the standard
  1380. group editing method. The groups are listed on the left side
  1381. of the screen (complete with description and read-only flag).
  1382. You can press the Insert key to add new groups, or use the
  1383. Delete key to remove one. After pressing Insert, a new list
  1384. pops up on the right side of the screen. Select the group you
  1385. want to add with the cursor keys and then press Enter. If you
  1386. change your mind and don't want to add a group, simply press
  1387. Escape. When you are done changing the groups, you have to
  1388. press Escape or F10 to return to this screen again.
  1389. WaterGate manual                                        [page 23]
  1390.  
  1391. More advanced users can also use tagging to add or remove more
  1392. than one group at a time. Use the F5, F6, and F7 keys for
  1393. tagging. F5 selects or deselects one item; with F6 you can
  1394. select all the lines that match a certain search string (an
  1395. empty string matches all); and F7 deselects all lines that
  1396. match a certain search string.
  1397.  
  1398. ArcMail names
  1399. -------------
  1400.  
  1401. When creating outgoing fido mail archives, WaterGate can
  1402. create mail bundles that use the following name extension
  1403. conventions:
  1404.  
  1405.      (day of week) + 0..9          ArcMail
  1406.      (day of week) + 0..9, A..F    Hex
  1407.      (day of week) + 0..9, A..Z    All
  1408.  
  1409. Ensure that the software your up- and downlinks are using can
  1410. handle the format you specify. The default setting is ArcMail,
  1411. which results in archive bundles with names like .SU0, .TH2,
  1412. .FR4, etc.
  1413.  
  1414. WaterGate keeps track of the digit or letter it last used for
  1415. each user. If the .SU0 file has been sent, for example,
  1416. WaterGate will create a .SU1 file instead of a new .SU0 file.
  1417. WaterGate manual                                        [page 24]
  1418.  
  1419. Fido MessageBases
  1420. -----------------
  1421.  
  1422. If you select the Fido Messagebases option from the System
  1423. Settings menu, you will be presented a screen that looks like
  1424. this. This screen contains all the important settings related
  1425. to the local message bases.
  1426.  
  1427.      +-----------------------------------------+
  1428.      | Auto link         OFF on                |
  1429.      | Strip SeenBy      off ON                |
  1430.      | Replace Tear      off ON                |
  1431.      |                                         |
  1432.      | Default number    200                   |
  1433.      | Default days      5                     |
  1434.      |                                         |
  1435.      | Netmail type      MSG squish jam        |
  1436.      | Netmail path      D:\NODE\NET\          |
  1437.      | Badmail type      NONE msg squish jam   |
  1438.      | Badmail path                            |
  1439.      | Dupemail type     NONE msg squish jam   |
  1440.      | Dupemail path                           |
  1441.      | Auto Create Type  NONE msg squish jam   |
  1442.      | Default new path  E:\NODE\NEW\          |
  1443.      +-----------------------------------------+
  1444.  
  1445. Auto Link
  1446. ---------
  1447.  
  1448. Toggle "Auto Link" to ON if you want WaterGate to link
  1449. messages in all areas that received new mail during the mail
  1450. toss. You might want to turn this off and save time if you
  1451. toss a lot of small mail bundles containing only a few new
  1452. messages. To link your message areas, you can then use
  1453. WaterUtil's 'Link All' option.
  1454.  
  1455. Strip SEEN-BY
  1456. -------------
  1457.  
  1458. Toggle "Strip SeenBy" to ON if you want to save harddisk space
  1459. by NOT importing SEEN-BY lines into your message base.
  1460. Remember that re-exporting messages with incomplete SEEN-BY
  1461. lines is often considered a capital crime.
  1462.  
  1463. Replace Tearline
  1464. ----------------
  1465.  
  1466. The "Replace Tear" option is only available for registered
  1467. users, the setting is ignored for the unregistered version. If
  1468. you set to ON, the program will replace all tear lines it
  1469. finds in locally generated messages with its own. Tear-lines
  1470. are also added to messages that are converted by WaterGate
  1471. from UUCP to Fidonet.
  1472. WaterGate manual                                        [page 25]
  1473.  
  1474. The result is something like:
  1475.  
  1476.      --- WtrGate v1.00 Unreg
  1477.      --- WtrGate+ v1.00
  1478.  
  1479. Default number and days
  1480. -----------------------
  1481.  
  1482. When a new area is created, these two values are put in the
  1483. "Fido limit" and "Fido age" fields. The first is the maximum
  1484. number of messages you want to have in a messagebase and the
  1485. second is the maximum age of a message. If the message is
  1486. older, it will be removed when cleaning the messagebase.
  1487.  
  1488. Netmail messagebase
  1489. -------------------
  1490.  
  1491. Since a Netmail message base is required by WaterGate, enter a
  1492. full path to it under "Netmail path". You can choose to make
  1493. it a *.MSG, Squish, or JAM base. Use "Netmail type" to choose
  1494. your preferred type.
  1495.  
  1496. If you set it to *.MSG, the path has to point to a directory.
  1497. If you set it to Squish or JAM, the path has to include the
  1498. messagebase name without an extension.
  1499.  
  1500. If you■re using FrontDoor as your Fido system type, then a
  1501. *.MSG directory is required!  Also, for compatibility with
  1502. many other programs, usage of a *.MSG netmail path is advised.
  1503.  
  1504. Notice that you DO NOT have to create an Area Record (Area
  1505. definitions from the main menu) for the netmail area, nor the
  1506. badmail or dupes message areas! Doing so might result in
  1507. operational problems.
  1508.  
  1509. Badmail messagebase
  1510. -------------------
  1511.  
  1512. If you want to keep track of messages that somehow go wrong,
  1513. then enable the Badmail message base. Use the "Badmail type"
  1514. option to enable this option or select NONE to disable it.
  1515. Make sure you enter a correct path under "Badmail path".
  1516. WaterGate uses the "Default Number" and "Default Days"
  1517. settings to clean up your Badmail.
  1518.  
  1519. Dupes messagebase
  1520. -----------------
  1521.  
  1522. If WaterGate finds a duplicate message, it deletes it by
  1523. default. If you want to keep track of these messages, you can
  1524. setup a messagebase to put them in. Just as with netmail and
  1525. badmail you have to set a type and enter a path.
  1526. WaterGate manual                                        [page 26]
  1527.  
  1528. Auto create type and default path
  1529. ---------------------------------
  1530.  
  1531. If a message arrives in an unknown area and the user that sent
  1532. it has the "Create new areas" option in his user record set to
  1533. YES, WaterGate automatically creates an area record in the
  1534. areabase.
  1535.  
  1536. If you want that area as a messagebase later on, you have to
  1537. enter the path to the messagebase and set the correct type.
  1538. The path might be a lot of typing work, so you can enter the
  1539. default path for the messagebase in the "Default new path"
  1540. field.
  1541.  
  1542. If you also want to have a messagebase created for it (very
  1543. handy for small systems, like points, where you know that the
  1544. new areas are OK), you can set the messagebase type for these
  1545. areas in the "Auto Create Type" field.
  1546.  
  1547. Because you need a messagebase name for Squish and JAM,
  1548. WaterGate automagically creates one for you. Since the first
  1549. eight characters of an area are not unique (and completely
  1550. useless for Usenet areas like ALT.BBS.SOMETHING, where you
  1551. have the dots), WaterGate creates a magic number. This is the
  1552. CRC32 value of the complete string that represents the area-
  1553. name, padded with spaces to the maximum length. This number is
  1554. used as the filename (Squish, JAM) or directory name (*.MSG)
  1555. for that messagebase.
  1556.  
  1557. The only disadvantage of this magic number is that the real
  1558. areaname cannot be determined from the base-name, other than
  1559. by consulting the configuration program. You can manually
  1560. change the name of the message base afterwards, although
  1561. WtrConf will not (yet) rename the message base files
  1562. automatically. But if you use WtrConf to export a Squish
  1563. config file (also good for JAM bases!) and feed that to your
  1564. editor, you don't have to know the messagebase name at all!
  1565. WaterGate manual                                        [page 27]
  1566.  
  1567. Fido Compression Programs
  1568. -------------------------
  1569.  
  1570. Select "Fido Compression Programs" from the System Settings
  1571. sub-menu to enter a screen that looks like this:
  1572.  
  1573.      +-----------------------------------------+
  1574.      | ARC     PKPAK -OCT A                    |
  1575.      | UNARC   PKUNPAK /R                      |
  1576.      | ARJ     ARJ A -E                        |
  1577.      | UNARJ   ARJ E -N                        |
  1578.      | LZH     LHA A /M                        |
  1579.      | UNLZH   LHA E                           |
  1580.      | PAK     PAK A                           |
  1581.      | UNPAK   PAK E /WN                       |
  1582.      | ZIP     PKZIP -A                        |
  1583.      | UNZIP   PKUNZIP -O                      |
  1584.      | ZOO     ZOO -Add                        |
  1585.      | UNZOO   ZOO -Extract                    |
  1586.      | OP1                                     |
  1587.      | GUS                                     |
  1588.      | Default arc ARJ lzh pak zip zoo op1 pkt |
  1589.      +-----------------------------------------+
  1590.  
  1591. WaterGate is capable of recognizing 6 of the most widely used
  1592. compression programs within Fidonet: ARC, ARJ, LZH, PAK, ZIP,
  1593. and ZOO.
  1594.  
  1595. When it encounters compressed Fidomail bundles, it tries to
  1596. start the correct decompression program. If it is unable to
  1597. recognize the compression method, it checks whether a GUS
  1598. (General Unpack Shell) is defined and lets the GUS have a try
  1599. at it.
  1600.  
  1601. Use this screen to enter the correct program names and options
  1602. for each compression and decompression program. A special
  1603. option is 'OP1', which you can use to compress your mail using
  1604. a program unknown to WaterGate. There is, of course, no way
  1605. for WaterGate to recognize and decompress this sort of
  1606. archive.
  1607.  
  1608. Use the last line to select a Default type for WaterGate to
  1609. use in situations when it has to pack messages for an
  1610. undefined node, for example when sending crash mail messages.
  1611. This is also the default type for newly created user records.
  1612. WaterGate manual                                        [page 28]
  1613.  
  1614. Fido AreaFix Forwarding
  1615. -----------------------
  1616.  
  1617. WaterGate is capable of AreaFix forwarding for both Fidonet
  1618. and UUCP. When a user requests an area that is not available
  1619. at your system, WaterGate can ask one of your uplinks to start
  1620. sending that area.
  1621.  
  1622. When WaterGate does this, the area is created automatically
  1623. and both the requesting user and the uplink system are
  1624. connected at once.
  1625.  
  1626. The areas that can be requested dynamically are stored in one
  1627. or more listings on disk. You tell WaterGate what the node
  1628. number for your uplink is and which file to check for area
  1629. names. You can define up to ten (10) listings for Fidonet and
  1630. also ten for UUCP.
  1631.  
  1632. You can configure the Areafix forwarding by selecting Fido
  1633. areafix Forwarding from the System Configuration menu. You can
  1634. then select one of the ten entries and press enter to edit it.
  1635. You will see the following screen to edit an entry.
  1636.  
  1637.      +------------------------------------------+
  1638.      | Address       : 2:280/801                |
  1639.      | Unconditional : yes NO                   |
  1640.      | Arealist path : C:\BBS\AREALIST.BBS      |
  1641.      | Arealist type : AREAS.BBS name list      |
  1642.      | Area manager  : AREAFIX                  |
  1643.      | Password      : highbrazil               |
  1644.      | Group         : A                        |
  1645.      | Add "+"       : yes NO                   |
  1646.      +------------------------------------------+
  1647.  
  1648. Specify the Fido address of each uplink system in the
  1649. 'Address' field. When you flag an uplink as 'unconditional'
  1650. the request is always forwarded to this node, and WaterGate
  1651. makes no attempt to search the specified area list.
  1652.  
  1653. Specify the full path to the area listing in the "Arealist
  1654. path". Then select the type of listing: the AREAS.BBS type
  1655. follows 'standard' areas.bbs convention, while for the 'Name
  1656. list' each line in the file has to contain a single area name.
  1657.  
  1658. Select the program name of the Area Manager program on your
  1659. uplink system. Most should be capable of understanding the
  1660. default 'AreaFix'. The password is used when writing the
  1661. AreaFix message.
  1662.  
  1663. Specify to which group the new area is to be added. WaterGate
  1664. will only scan the lists for groups to which the requesting
  1665. user has access. Adding a '+' is used to support AreaFix
  1666. programs that need one for each requested area. Instead of
  1667. just listing the requested areas, each one has a '+' added in
  1668. front.
  1669.  
  1670. NOTICE: The current implementation (v0.22) only writes connect
  1671. requests to UUCPREQ.LST.
  1672. WaterGate manual                                        [page 29]
  1673.  
  1674. Setting up the UUCP System
  1675. --------------------------
  1676.  
  1677. This chapter explains in detail how to set up the UUCP side of
  1678. your WaterGate system. Other chapters will teach you how to
  1679. add systems (users) and newsgroups (areas).
  1680.  
  1681. If you don't have a UUCP connection, you can still use this
  1682. program perfectly well without entering any options in this
  1683. section.
  1684.  
  1685. UUCP settings
  1686. -------------
  1687.  
  1688. If you select "UUCP settings" from the System Settings menu,
  1689. you will be presented with the following screen:
  1690.  
  1691.      +----------------------------------------------------+
  1692.      | Organization        Waterline Software Development |
  1693.      | UUCP SPOOL path     C:\SPOOL\                      |
  1694.      | System UUCP name    water                          |
  1695.      | World registered    NO yes                         |
  1696.      | Smart host          seunet                         |
  1697.      | Backbone            Berkeley.EDU                   |
  1698.      | System domains      wsd.wline.se                   |
  1699.      |                     admin.wline.se                 |
  1700.      |                                                    |
  1701.      |                                                    |
  1702.      |                                                    |
  1703.      |                                                    |
  1704.      | Default groups                                     |
  1705.      | Time zone           GMT+1                          |
  1706.      | Maximum .DAT length 200000                         |
  1707.      | Undeliverable mail  netmail BOUNCE                 |
  1708.      | Bounce small        no YES                         |
  1709.      +----------------------------------------------------+
  1710.  
  1711. First of all, who are you? WaterGate will append an
  1712. "Organization" line to all messages it sends into Usenet. This
  1713. can be a message gated from Fidonet or a message created by
  1714. the system itself. You can enter a short line describing your
  1715. organization or company.
  1716.  
  1717.      Organization: Sweet Bug & Company, Holland
  1718.  
  1719. The spool directory system
  1720. --------------------------
  1721.  
  1722. The spool directory is a place to store outgoing and incoming
  1723. files for UUCP systems. Each system requires its own spool
  1724. subdirectory to store the files destined for or received from
  1725. that system.
  1726.  
  1727. The UUCICO program searches for .CMD files in this directory.
  1728. A .CMD file holds the names of the files to transfer.
  1729. WaterGate manual                                        [page 30]
  1730.  
  1731. News and mail is sent in .DAT files, where multiple news
  1732. messages go in one file (called a batch) and mail messages are
  1733. put in separate files.
  1734.  
  1735. The news batches can also be compressed using COMPRESS,
  1736. COMP430D, or GZIP and can have a special header on top of
  1737. that, called a "cunbatch" header.
  1738.  
  1739. The .DAT files contain all the data and the .XQT files contain
  1740. the processing statements and tells us whether it is a mail
  1741. message or a news batch. A program called XQT will then run
  1742. the correct program to process these files.
  1743.  
  1744. Since WaterGate is compatible with the spool directory
  1745. structure and has to create mail and news batches for systems
  1746. that process them as described above, WaterGate creates .DAT,
  1747. .XQT, and .CMD files.
  1748.  
  1749. The UUCICO does one thing more with .DAT and .XQT files when
  1750. sending them: the receiving system renames them to .D and .X,
  1751. so they can't overwrite any outgoing files. Since the .CMD
  1752. file is only a command file for UUCICO, it is not transferred.
  1753.  
  1754. When WtrGate (the program) runs, it searches the userbase for
  1755. UUCP style users, then checks if there is a subdirectory in
  1756. this spool directory for that user and creates one if it
  1757. doesn't exist already. It then searches for .X files and reads
  1758. these. According to the contents of the .X file it then
  1759. processes the .D file.
  1760.  
  1761. If something goes wrong during processing, or if it can't file
  1762. the .D file, it renames the .X and .D files to .BAX and .BAD.
  1763.  
  1764. You have to put the spool directory path in the second field
  1765. of the screen. Don't append any UUCPname whatsoever, just
  1766. enter the path up and until the directory that is usually
  1767. called SPOOL, as you can see in the example screen grab.
  1768.  
  1769. Note that the TBBS option module "PIMP" is not compatible with
  1770. this spool directory structure, although it is capable of
  1771. transferring files using the UUCP protocol.
  1772.  
  1773. UUCP name
  1774. ---------
  1775.  
  1776. The next field to fill in is your system's UUCPname. You don't
  1777. have to create yourself in the userbase (just as you don't
  1778. create a fido style user with your AKA), but WaterGate needs
  1779. to know your UUCPname during processing and it puts it in the
  1780. files it creates in the spool directories.
  1781.  
  1782. In our case, our UUCPname is "wsd", which has to be typed in
  1783. using the correct case (capital letters or not). The maximum
  1784. length of this name is 12 characters, of which only 7 are
  1785. significant.
  1786. WaterGate manual                                        [page 31]
  1787.  
  1788. Domain addresses
  1789. ----------------
  1790.  
  1791. Next are your domain addresses. This is the last part of your
  1792. e-mail address, behind the @ sign. For me (ramon@wsd.wline.se)
  1793. it is "wsd.wline.se". You can fill in up to 10 different
  1794. domain addresses.
  1795.  
  1796. WaterGate uses these names to see if a message is addressed to
  1797. itself, for example for newsfix or for the listserver.
  1798.  
  1799. If you have a world wide registered UUCPname, you are also
  1800. allowed to use the .UUCP convention, as in "wsd.UUCP". Don't
  1801. enter this if you don't have a world wide registered UUCPname!
  1802.  
  1803. The first domain address should be your primary (most
  1804. important) domain address. WaterGate uses this when it has to
  1805. write messages. The list server, for example, will always
  1806. advertise itself as listserver@<your first domain name> and
  1807. there are loads of other places where this first domain name
  1808. is used. Make sure this is your most important domain name.
  1809. The other domain names are just used to detect that a message
  1810. is for this system.
  1811.  
  1812. Examples of domain addresses:
  1813.  
  1814.      UUCPname:      rubbish
  1815.  
  1816.      Domain names:  rubbish.linknet.nl
  1817.                     rubbish.thehost.linknet.nl
  1818.                     rubbish.UUCP
  1819.  
  1820. In this example, WaterGate accepts mail addressed to
  1821. 'rubbish', 'rubbish.linknet.nl', 'rubbish.thehost.linknet.nl',
  1822. and 'rubbish.UUCP' as addressed to itself.
  1823.  
  1824. Smart host
  1825. ----------
  1826.  
  1827. If WaterGate receives a mail message that is not addressed to
  1828. any node it knows, it will try to send it to your smarthost,
  1829. UNLESS this mail message already came from there. In that
  1830. case, the message will be bounced to the original sender,
  1831. since the smarthost assumed the addressee (which can be a
  1832. subnode as well as a point) should be known at our site but,
  1833. since we don't know the addressee, it does not exist.
  1834.  
  1835. Your smarthost is usually the system from which you receive
  1836. your mailfeed. Even if that system is not capable of smart
  1837. routing, it should be able to transport the message to a
  1838. system that is.  Enter the UUCP name of your Smarthost in the
  1839. 'Smarthost' field. Important! Make sure you define a UUCP
  1840. style node for the system you assign as your smarthost.
  1841.  
  1842.      Smarthost: wtrlnd
  1843. WaterGate manual                                        [page 32]
  1844.  
  1845. Backbone
  1846. --------
  1847.  
  1848. When sending messages in moderated newsgroups, you either know
  1849. the moderator, or it is sent to a backbone site capable of
  1850. transporting it to the correct moderator. THIS IS USUALLY NOT
  1851. YOUR SMARTHOST. If you don't know a backbone site closer to
  1852. you, leave the setting at its default.
  1853.  
  1854.      Backbone: Berkeley.EDU
  1855.  
  1856. Default groups
  1857. --------------
  1858.  
  1859. When new UUCP style users are created, you can connect them to
  1860. a default combination of area groups. Just select the groups
  1861. you want using "Def. Groups". See the fido style default group
  1862. setup for a complete explanation of how to select and deselect
  1863. groups.
  1864.  
  1865. Time zone
  1866. ---------
  1867.  
  1868. Messages created by WaterGate contain a time field that is
  1869. created using the system date and time, and the "Time Zone"
  1870. string added to it.
  1871.  
  1872.      Time zone: GMT
  1873.  
  1874. results in:
  1875.  
  1876.      Fri, 19 Nov 1993 04:12:50 GMT
  1877.  
  1878. According to the RFC regulations, this field should contain an
  1879. official TimeZone identifier. Many sites in Europe tend to use
  1880. 'CET' here, for 'Central European Time', commonly used by
  1881. European cable and satellite stations such as MTV-Europe.
  1882. However, this is NOT an official TimeZone!
  1883.  
  1884. Instead, European sites should indicate their relation to
  1885. Greenwich time by using the timezone identifier, GMT, plus an
  1886. adjustment. For the European mainland, this is GMT+1 in
  1887. winters, and GMT+2 in summers (this is a direct result of the
  1888. phenomenon 'daylight savings').
  1889.  
  1890. Some people like to put phony timezone identifiers here; this
  1891. may be tremendous fun, but, although it won■t bother
  1892. WaterGate, correct mailhandling by your smarthost or other
  1893. mail systems involved cannot be guaranteed. There are some
  1894. systems that seem to have a lot of CPU time left and they
  1895. check to make sure this time zone is a valid string. If it is
  1896. not, they simply trash the entire message! RFC1036 advises
  1897. using the GMT timezone.
  1898. WaterGate manual                                        [page 33]
  1899.  
  1900. Maximum bundle size
  1901. -------------------
  1902.  
  1903. By default, WaterGate will append news messages to the same
  1904. outgoing mail bundle for each UUCP node during one toss. Mail
  1905. messages are always put in a separate file.
  1906.  
  1907. If you have downlinks that have trouble with large UUCP *.DAT
  1908. files you may want to set the ".DAT length" option. WaterGate
  1909. will then check whether a UUCP message bundle exceeds that
  1910. limit. If so, it closes it and creates a new one. A setting of
  1911. "0" disables this option. The default is "200000" (200k)
  1912. bytes; remember that this is before compression!
  1913.  
  1914. Undeliverable mail
  1915. ------------------
  1916.  
  1917. When a message is sent to your system, but it cannot be
  1918. delivered because the target system does not exist, then
  1919. something has to be done with that message. For example, when
  1920. a message is sent to my system for "somehost.wsd.wline.se",
  1921. then this message cannot reach it destination because the host
  1922. "somehost" does not exist as a sub-domain of my system.
  1923.  
  1924. In that case, there are two options. First, the message could
  1925. be sent back to the originator, which can then take
  1926. appropriate actions. Second, it can be written to the netmail
  1927. area, so the administrator can have a look at it.
  1928.  
  1929. Bounce small
  1930. ------------
  1931.  
  1932. When a undeliverable mail message is sent back, then you want
  1933. to be able to control how big that message is. For example, it
  1934. is no use to send an undeliverable UU-encoded mail message of
  1935. 100kb back to somebody. Instead, only the headers and perhaps
  1936. the first part of the message should be sent back. This is
  1937. enough for the originator to find out what was wrong.
  1938.  
  1939. If you don't care about your telephone bill, then set this
  1940. option to NO, in which case the entire message will be sent
  1941. back to the originator.
  1942. WaterGate manual                                        [page 34]
  1943.  
  1944. UUCP Compression Programs
  1945. -------------------------
  1946.  
  1947. Outgoing UUCP news batches have to be compressed with either
  1948. the COMPRESS/COMP430D program or GZIP. WaterGate can detect
  1949. the compression method used for incoming news batches and will
  1950. automatically spawn the correct decompression program.
  1951.  
  1952. You can enter the details and arguments of these programs in
  1953. this screen.
  1954.  
  1955.      +----------------------------+
  1956.      | COMPRESS   COMP430D -v     |
  1957.      | DECOMPRESS COMP430D -dv    |
  1958.      | ZIP        GZIP -v         |
  1959.      | UNZIP      GZIP -dv        |
  1960.      +----------------------------+
  1961.  
  1962. For use with COMPRESS it is wise to define a decompressor here
  1963. that can handle (and recognize) both 12 and 16 bit
  1964. compression. WaterGate will usually be able to free up enough
  1965. memory to perform 16 bit compression and decompression when
  1966. shelling out to the (de)compressor by swapping itself to
  1967. XMS/EMS/Disk.
  1968.  
  1969. Make sure you have the correct compression programs. You can
  1970. find these on the Simtel 20 CD-ROM. On the September 1994
  1971. release it was on disc 2 in the directory \DISC2\COMPRESS.
  1972. BBS's might use the description for this directory, which is
  1973. "MS-DOS port of UNIX compress, gzip; and compression pgms".
  1974.  
  1975. The names of the files are:
  1976.  
  1977.      COMP430D.ZIP
  1978.      GZIP124.ZIP
  1979.  
  1980. Don't use PKZIP for GZIP compression or decompression because
  1981. this will not work!
  1982. WaterGate manual                                        [page 35]
  1983.  
  1984. UUCP newsfix forwarding
  1985. -----------------------
  1986.  
  1987. Newsfix forwarding is exactly like Areafix forwarding, but
  1988. then for UUCP areas. When a user requests a newsgroup that
  1989. your system currently doesn't have, you can have WaterGate
  1990. scan a list of all available newsgroups.
  1991.  
  1992. But, since there is no 'standard' AreaFix alike program for
  1993. UUCP mail processors, WaterGate is unable to forward a request
  1994. for such an area. To aid in the development of utilities that
  1995. can interface with your UUCP host it is capable of creating a
  1996. text file named UUCPREQ.LST on disk that contains the name of
  1997. the requested area, and the system it has to be requested
  1998. from.
  1999.  
  2000. You can define up to ten (10) listing files and uplink
  2001. systems. Normally there will only be one UUCP uplink, so you
  2002. can ulitize the ten entries to split the listing of
  2003. newsgroups.
  2004.  
  2005. To configure the newsfix forwarding, select UUCP newsfix
  2006. forwarding from the System Configuration menu. You will then
  2007. be presented with the following screen:
  2008.  
  2009.      +------------------------------------------+
  2010.      | UUCP Name Filename                       |
  2011.      | seunet   |e:\newsgrps                    |
  2012.      |          |                               |
  2013.      |          |                               |
  2014.      |          |                               |
  2015.      +------------------------------------------+
  2016.  
  2017. In the column "UUCP Name" you fill in the UUCPname of the
  2018. uplink system. This name will be writting to the UUCPREQ.LST
  2019. file.
  2020.  
  2021. The column "Filename" must contain the full path to the
  2022. newsgroups listing. This can be a Waffle newsgroup listing
  2023. compatible file with both the newsgroup name and the
  2024. description. When the area is create, the description is put
  2025. in automatically.
  2026. WaterGate manual                                        [page 36]
  2027.  
  2028. Gateway Settings
  2029. ----------------
  2030.  
  2031. The gateway is the path messages take when they have to be
  2032. sent from UUCP to Fidonet or vice versa. The message body is
  2033. translated to the new format and the headers (from, to,
  2034. subject, date, etc.) have to be translated as well. WaterGate
  2035. does this all automatically.
  2036.  
  2037. There are a few settings you can tune, almost all of which
  2038. have to do with addressing the gateway and translating
  2039. addresses. "The Gateway", below, will explain how to use the
  2040. gateway and how to set up mappings, which are address
  2041. translation helpers.
  2042.  
  2043. You can reach the Gateway Settings screen via the System
  2044. Settings menu. That screen looks like this:
  2045.  
  2046.      +------------------------------------------------+
  2047.      |                    --- Fido-only ---           |
  2048.      | Gateway            2:280/802@joho              |
  2049.      | Gateway User       UUCP                        |
  2050.      | Gateway TO         no YES                      |
  2051.      | Kill gated netmail NO yes                      |
  2052.      |                    --- UUCP to Fido ---        |
  2053.      | FSC-35 kludges?    no YES                      |
  2054.      | Fido From:         e-mail address FULL NAME    |
  2055.      | Copy headers       <press enter to edit>       |
  2056.      | ASCII Conversion   <press enter to edit>       |
  2057.      |                    --- Both directions ---     |
  2058.      | Name separator     _                           |
  2059.      | Small addresses    no YES                      |
  2060.      +------------------------------------------------+
  2061.  
  2062. The screen is split up in three parts, related to Fidonet
  2063. addressing, Fidonet to UUCP translation, and translations in
  2064. both directions.
  2065.  
  2066. Gateway AKA
  2067. -----------
  2068.  
  2069. To address the gateway from within Fidonet, you need to send
  2070. the message to the AKA of your system you have selected as the
  2071. Gateway AKA.
  2072.  
  2073. Gateway User
  2074. ------------
  2075.  
  2076. In order for WaterGate to know that a message must go through
  2077. the gateway, you have to tell it what username will appear in
  2078. the To: field of messages destined for the gateway.  The
  2079. default is UUCP, a common choice, but it can be changed to
  2080. anything.
  2081. WaterGate manual                                        [page 37]
  2082.  
  2083. Then you can put the UUCP address (of the person to whom you
  2084. want to send your message) on the first line of the netmail
  2085. message body, preceded by "To:" (case in-sensitive).
  2086.  
  2087. Gateway TO
  2088. ----------
  2089.  
  2090. If the option "Gateway TO" is set to YES, WaterGate also scans
  2091. the To: field of the netmail for a UUCP address. In that case,
  2092. you don't have to put the UUCP address on the first line of
  2093. the body of the message, but you can then simply put it in the
  2094. To: field of the Fidonet message.
  2095.  
  2096. Kill gated netmail
  2097. ------------------
  2098.  
  2099. If you write a message in the netmail area that has to be sent
  2100. to UUCP, you may want it to remain there after it has been
  2101. sent so you can move it to another area (history, for
  2102. example). If you don't want it to stay in the netmail area
  2103. after gating it, you can put the Kill/Sent flag on it with
  2104. your editor.
  2105.  
  2106. If one of your points or downlinks sends a netmail to the
  2107. gateway and he or she does not put a Kill/Sent flag on the
  2108. message, this message will remain in your netmail area after
  2109. it has been gated. After a while, these messages pile up.
  2110.  
  2111. If you set this toggle to YES, all netmails that were gated to
  2112. UUCP are automatically given a Kill/Sent flag, so WaterGate
  2113. deletes them after gating. This keeps your netmail area free
  2114. of already gated messages.
  2115.  
  2116. FSC-35 kludges
  2117. --------------
  2118.  
  2119. If a message is translated from UUCP to Fidonet, you have to
  2120. be able to reply to it from within your editor. This can be
  2121. done in several ways. The newer editors support FSC-35, which
  2122. makes replying to a message from UUCP very simple. Two kludges
  2123. are added to the message: REPLYTO and REPLYADDR. The first
  2124. contains the AKA and username of the gateway and the second
  2125. holds the internet address of the sender of the message
  2126. (that's where the reply has to go).
  2127. If there are more than one possible reply address, then
  2128. WaterGate creates one or more REPLYALSO kludges as well.
  2129.  
  2130. Fido From:
  2131. ----------
  2132.  
  2133. If your editor does not support FSC-35, you have to reply to
  2134. the message by manually putting the UUCP address on the first
  2135. line of the message. But since WaterGate is also capable of
  2136. finding the recipient■s address in the fido To: field, it
  2137. would be handy if it was in the From: field of the message you
  2138. are going to reply to. Your editor will then automatically
  2139. setup a message from you to whatever was in the From: field.
  2140. If this is the complete internet address, you are done and
  2141. WaterGate manual                                        [page 38]
  2142.  
  2143. don't need to type anything more. Set this option to "e-mail
  2144. address" if you want this.
  2145.  
  2146. If the e-mail address does not fit in the To: field of the
  2147. message, WaterGate automatically puts the address of the
  2148. sender in the body of the message, preceded by "Message
  2149. Sender:".
  2150.  
  2151. If your editor does support FSC-35, you don't need the UUCP
  2152. address in the From: field of the message. Some addresses are
  2153. very ugly to look at and it would be much nicer if the full
  2154. name of the sender of the message was in this field, as with
  2155. normal Fidonet messages. If you set the option "Fido From:" to
  2156. "full name", WaterGate puts the full name of the sender of the
  2157. UUCP message in the From: field.
  2158.  
  2159. If you want the full name of the sender in the From: field and
  2160. the address in the body of the message, you have to use Copy
  2161. Headers.
  2162.  
  2163. Copy Headers
  2164. ------------
  2165.  
  2166. A UUCP messages contains several "header" lines. If a message
  2167. is gated to a Fidonet message, these headers are lost, unless
  2168. you use this option. You have to put the cursor on this field
  2169. and then press Enter to change the settings. You will then see
  2170. the following screen:
  2171.  
  2172.      +---------------------------------+
  2173.      | Header name     Copy whereto    |
  2174.      |                                 |
  2175.      | From:           not KLUDGE text |
  2176.      | To:             not KLUDGE text |
  2177.      | Subject:        not KLUDGE text |
  2178.      | Date:           not KLUDGE text |
  2179.      | Message-Id:     NOT kludge text |
  2180.      | Organization:   not kludge TEXT |
  2181.      | From            NOT kludge text |
  2182.      | Path:           not kludge TEXT |
  2183.      | Newsgroups:     not kludge TEXT |
  2184.      |                 NOT kludge text |
  2185.      +---------------------------------+
  2186.  
  2187. You can put the header name (case insensitive) in the left
  2188. column and select the way it shows up in the Fidonet message
  2189. in the right column.
  2190.  
  2191. If it is on NOT, it will not be searched for at all, if it is
  2192. on KLUDGE, it shows up as a kludge line and if it is on TEXT
  2193. it is put in the Fidonet message body as clear text.
  2194.  
  2195. The left column has some default header lines filled in, but
  2196. you can edit each of them. WaterGate searches for the header
  2197. line with a space appended to it. This is important, because
  2198. "From" and "From:" are different headers and we don't
  2199. necessarily want to match both. Also, don't forget the
  2200. terminating colon (':') after the header name!
  2201. WaterGate manual                                        [page 39]
  2202.  
  2203. ASCII conversion
  2204. ----------------
  2205.  
  2206. High ASCII characters (values >128) are widely used within
  2207. Fidonet, but are illegal within UUCP. WaterGate will replace
  2208. those characters when converting a message into UUCP format
  2209. using a conversion table.
  2210.  
  2211. You can specify an appropriate Low ASCII value for each High
  2212. ASCII value. For example, characters with an umlaut can be
  2213. replaced with their equivalent without the umlaut. To support
  2214. computers that are using a different high ASCII table than the
  2215. Latin one used in most American and European computers, you
  2216. can use the 'ASCII conversion' option to re-define the default
  2217. table.
  2218.  
  2219. Name separator
  2220. --------------
  2221.  
  2222. The name separator is used to convert Fido names to names
  2223. compatible with UUCP systems. It replaces all spaces in the
  2224. Fido user name with the character you configure here.
  2225.  
  2226. Examples:
  2227.  
  2228.      "Jaap Aap"
  2229.   -> Jaap_Aap@...
  2230.  
  2231.      "Ramon van der Winkel"
  2232.   -> Ramon_van_der_Winkel@...
  2233.  
  2234.      "Michel van.der.Laan"
  2235.   -> Michel_van.der.Laan@...
  2236.           
  2237. The default is to use the underscore ('_'), because some BBS
  2238. users still use dots ('.') to separate the parts of their
  2239. names, as in the last example. The problem with those names is
  2240. not the translation TO UUCP, but FROM UUCP. If the last
  2241. example was translated with a dot, it would be
  2242. "Michel.van.der.Laan". If that is translated back, you get
  2243. "Michel van der Laan", instead of "Michel van.der.Laan".
  2244. WaterGate manual                                        [page 40]
  2245.  
  2246. Small addresses
  2247. ---------------
  2248.  
  2249. The small addresses option is used to keep Fido addresses in
  2250. UUCP messages as small as possible. If WaterGate has to put
  2251. the sender■s Fidonet address in a UUCP address, it creates an
  2252. address with this format:
  2253.  
  2254. z<zone>.n<net>.f<node>.p<point>.<first system domain address>
  2255.  
  2256. For example: 2:280/802.33 -> z2.n280.f802.p33.wlink.nl
  2257.  
  2258. But a lot of this information is actually unnecessary if your
  2259. gateway AKA closely matches this address, for example
  2260. 2:280/802.
  2261.  
  2262. If "Small Addresses" is set to YES, WaterGate removes all the
  2263. parts of the Fido address that match, so the result would then
  2264. be:
  2265.  
  2266.      p33.wlink.nl
  2267.  
  2268. Your system■s points are just 
  2269.  
  2270.      user@p<pointnr>.wlink.nl
  2271.  
  2272. and that is a lot better-looking than the complete, big
  2273. address.
  2274.  
  2275. When a message is received from UUCP in the form above, the
  2276. gateway AKA is again used to reconstruct the full Fidonet
  2277. recipient■s address.
  2278.  
  2279. Note that if your gateway AKA contains a point number, this
  2280. point number is ignored when constructing the complete
  2281. address. Otherwise the point number would always be in the
  2282. recipient■s address (also if that is a node), if it was not in
  2283. the UUCP address. So, you can safely use a point number for
  2284. your gateway.
  2285. WaterGate manual                                        [page 41]
  2286.  
  2287. Private mail settings
  2288. ---------------------
  2289.  
  2290. Scanning through your mail areas, wondering if anybody wrote
  2291. you a message can become quite a tedious job if you subscribe
  2292. to lots of areas. And then there all the areas that pass
  2293. through your system but aren't imported, so you'll never know
  2294. if somebody isn't desperately trying to give you that "change
  2295. of a lifetime <tm>" (Starting to feel a little paranoid?)
  2296.  
  2297. Well fear no more! Simply select "Private Mail Options" from
  2298. the "System Settings Menu". Choose what kind of messagebase
  2299. you want to use to store those private messages, or select
  2300. NONE to disable all private mail copying. Make sure you enter
  2301. a correct path for the base! You need to enter a directory
  2302. name for *.MSG or a complete path plus filename (without
  2303. extension!) for JAM and Squish.
  2304.  
  2305. WaterGate is capable of scanning for messages TO or FROM a
  2306. certain user, or with a certain SUBJECT. Comparisons are case-
  2307. insensitive, so 'Spock', 'SPOCK' and 'SpOcK' should all work
  2308. OK.
  2309.  
  2310. The search strings you enter don't have to match what you■re
  2311. searching for completely. For example, "Ramon" will find all
  2312. messages, either to my e-mail address ramon@wsd.wline.se, or
  2313. my munged address Ramon.van.der.Winkel@p33.wline.se, or even
  2314. when somebody uses my name (even misspelled) in a subject,
  2315. like "What I think about Ramona". If the search string you
  2316. enter can be found in the searched lines, then you have a
  2317. match.
  2318.  
  2319. The matching messages are completely copied into the
  2320. messagebase, preceded by a short notice that the message was
  2321. copied.
  2322.  
  2323. The private mail scan searches incoming netmail, echomail,
  2324. mail, and news. Messages that are leaving your message bases
  2325. are not scanned, although certain constructions might cause a
  2326. hit on those messages as well.
  2327. WaterGate manual                                        [page 42]
  2328.  
  2329. Logfile settings
  2330. ----------------
  2331.  
  2332. WaterGate is capable of logging a lot of things. Not only
  2333. error messages, but also progress of tossing for both Fidonet
  2334. and UUCP. These progress log lines can take up an awful lot of
  2335. logfile and you might not even be interested in them at all.
  2336.  
  2337. If you select "Logfile settings" from the "System Settings"
  2338. sub-menu of WtrConf, then you can toggle various logging
  2339. information generators on and off.
  2340.  
  2341. If you want to debug your WaterGate configuration, you can
  2342. choose to set the Debug option to YES, which will
  2343. automatically enable all other options you can set.
  2344.  
  2345. Currently, you can disable a number of 10 or so of the logfile
  2346. information generators, but more will be added in the future.
  2347. WaterGate manual                                        [page 43]
  2348.  
  2349. Administrator
  2350. -------------
  2351.  
  2352. New since version 0.20 is the administrator. This user
  2353. administrates the WaterGate program and the flow of messages.
  2354. In case of trouble, the administrator should solve things.
  2355.  
  2356. To support a "remote" administrator, the administrator address
  2357. was built in. You can either have a UUCP style administrator
  2358. or Fidonet style administrator, which require different
  2359. addresses.
  2360.  
  2361. Following is the configuration screen for the Administrator
  2362. Settings.
  2363.  
  2364.      +-----------------------------------------------------+
  2365.      | Administrator Settings                              |
  2366.      |                                                     |
  2367.      | Address type   disable FIDO uucp                    |
  2368.      |                                                     |
  2369.      | Fido username  WaterGate Administrator              |
  2370.      | Fido address   1:2/3.4                              |
  2371.      |                                                     |
  2372.      | E-mail address                                      |
  2373.      |                                                     |
  2374.      | Send log?      no YES                               |
  2375.      |                                                     |
  2376.      |                (more to come in future releases)    |
  2377.      +-----------------------------------------------------+
  2378.  
  2379. At this moment, you can only use the administrator to send it
  2380. a copy of the part of the logfile that was last added by the
  2381. wtrgate.exe or wtrgated.exe program.
  2382.  
  2383. In future, it will be possible to use the administrator to
  2384. help WaterGate in its decisions on where to send mail
  2385. messages, and possible to edit the configuration.
  2386. WaterGate manual                                        [page 44]
  2387.  
  2388. Groups
  2389. ------
  2390.  
  2391. Before discussing message area setup, it is important to know
  2392. about groups.
  2393.  
  2394. If you have a lot of areas, there might be a few that you
  2395. don't want all the users to read, for example the SysOp areas.
  2396. Because users can connect and disconnect areas themselves,
  2397. using AreaFix or newsfix, there has to be a way to
  2398. differentiate these areas from each other.
  2399.  
  2400. If you are in more than one network, it is also important to
  2401. keep the areas of the different networks separated. Every
  2402. network has its own AKAs that have to be used in messages
  2403. written in those networks. If you connect some of these areas
  2404. to UUCP, the correct AKA has to be used when a message is
  2405. gated from UUCP.
  2406.  
  2407. WaterGate uses "groups" to keep the areas separated. The
  2408. groups are named A through Z, where Z is a special group for
  2409. automatically created new areas. You can enter a description
  2410. for each of the groups, so it is easy to tell them apart, and
  2411. you can select a "Default origin AKA" for every group.
  2412.  
  2413. You can then select which areas belong in which groups. It is
  2414. also possible for an area to be in more than one group at a
  2415. time.
  2416.  
  2417. You can give your users access to some of the groups. They can
  2418. then use AreaFix or newsfix to connect areas that are in those
  2419. groups and nothing else.
  2420.  
  2421. It is also possible to make a group read-only. This means that
  2422. users can connect to an area in that group and receive
  2423. messages from it, but cannot write a message back. If you only
  2424. want this for some of your users, you can put these areas in
  2425. two groups: one read-only and one read/write. If you put an
  2426. area in a read-only group, you have to put it in a read/write
  2427. area as well or your uplink will not be able to deliver any
  2428. messages to this area.
  2429.  
  2430. You can edit the group descriptions, default origin AKA, and
  2431. read-only flag via the "Group descriptions" option in
  2432. WtrConf's main menu.
  2433. WaterGate manual                                        [page 45]
  2434.  
  2435. Creating Areas
  2436. --------------
  2437.  
  2438. This section explains in detail how to create an area. An area
  2439. can be either a Fidonet echomail area or a Usenet newsgroup.
  2440. It is possible for both Fidonet style users and UUCP style
  2441. users to be subscribed (as we call it) to the same area. If a
  2442. message has to be sent to both UUCP and Fidonet style users,
  2443. WaterGate automatically translates the message.
  2444.  
  2445. So, if you want to give your points access to newsgroups, then
  2446. just create the areas and subscribe the points to them. It
  2447. works the same the other way around: if you want a UUCP system
  2448. to receive Fidonet echomail, then just create the area and
  2449. connect the UUCP user.
  2450.  
  2451. This has two advantages. First, you only have to define an
  2452. area once and, second, WaterGate can bundle the message very
  2453. quickly. If it is an echomail message, WaterGate first bundles
  2454. it for all subscribed Fidonet users, then translates it (if
  2455. there are any connected UUCP users), and finally bundles it
  2456. for all the UUCP users. (In fact, WaterGate can even be
  2457. extended to use another formats in the future and was designed
  2458. with that in mind).
  2459.  
  2460. To create a new area, select "Area definitions" from WtrConf's
  2461. main menu. You will then be presented with a list of all 26
  2462. groups (A to Z). Select one group (or more, using tagging)
  2463. that you want to see all the areas from. Then press enter.
  2464.  
  2465. If you have a lot of areas (1000+), it might take a while
  2466. before the list with all the areas names has been constructed.
  2467. It is possible to abort this by pressing Escape. But in the
  2468. end, you will have a sorted list with all the areas and the
  2469. header line of the lists will show the groups you selected.
  2470.  
  2471. You can now press Insert to add a new area, or press the
  2472. Delete key to remove one. If you want to look at one or edit
  2473. it, highlight it and press the Enter button. If you want to go
  2474. back to the previous menu, just press Escape.
  2475.  
  2476. After pressing Enter or Insert, you are presented with the
  2477. screen on the following page. It contains all the settings you
  2478. can change for a certain area. You can use the up and down
  2479. cursor keys to move through all the fields. If you want to
  2480. change a field, you have to press Enter first.
  2481.  
  2482. If you want to exit the screen, you can press Escape or F10
  2483. (escape is more like abort, but they act the same). If you are
  2484. creating a new area, you are asked if you want to save the new
  2485. area. If you select Yes, certain fields have to be filled in
  2486. correctly and WtrConf checks that for you.
  2487. WaterGate manual                                        [page 46]
  2488.  
  2489. Some of the fields contain the text "<press enter to ...>". If
  2490. the cursor is on one of these fields and you press enter to
  2491. edit it, you will be presented another screen. The same thing
  2492. happens when you edit the "In groups" field.
  2493.  
  2494.      +---------------------------------------------+
  2495.      | Fido name     ALT.BBS.WATERGATE             |
  2496.      | Usenet name   ALT.BBS.WATERGATE             |
  2497.      | Comment       WaterGate support area        |
  2498.      | Area type     ECHO net local                |
  2499.      |                                             |
  2500.      | In groups     A                             |
  2501.      | Subscribers   <press enter to see list>     |
  2502.      | Allow Passive no YES                        |
  2503.      | Passive       NO yes                        |
  2504.      | Origin        BOFH is watching you!         |
  2505.      | Custom                                      |
  2506.      | Origin AKA    2:280/802                     |
  2507.      | Add SEEN-BY   <press enter to see list>     |
  2508.      | Moderated     NONE use                      |
  2509.      | Moderator                                   |
  2510.      |                                             |
  2511.      | Fido base     none msg squish JAM           |
  2512.      | Fido path     W:\MSGS\3215E24A              |
  2513.      | Fido age      5                             |
  2514.      | Fido limit    200                           |
  2515.      +---------------------------------------------+
  2516.  
  2517. Area name
  2518. ---------
  2519.  
  2520. The first two lines of the screen hold the area names for
  2521. Fidonet and Usenet. Normally these names will be the same, but
  2522. is possible to change the name of an area. We could change the
  2523. Fido name to "WTRGATE.028", for example.
  2524.  
  2525. If you enter a name in the "Fido name" field, and there is no
  2526. name in the "Usenet name" field, it is automatically copied.
  2527. The same thing happens if you enter an area name in the Usenet
  2528. name field and the Fido name field is empty. This saves you
  2529. some typing and prevents errors.
  2530.  
  2531. Comment
  2532. -------
  2533.  
  2534. You can use the Comment field to describe the message flow in
  2535. this area. This line is put in lists that AreaFix or newsfix
  2536. create, to make it is easy for your users to see which area
  2537. might be interesting to connect.
  2538. WaterGate manual                                        [page 47]
  2539.  
  2540. Area type
  2541. ---------
  2542.  
  2543. There are three types of areas: echo, net, and local. "Local"
  2544. is an area that is connected to a message base on your
  2545. harddisk (more on that later), "net" stands for netmail. This
  2546. way you can define other-than-the-primary netmail areas. The
  2547. usual setting though is "echo", which stands for Echomail.
  2548.  
  2549. In groups
  2550. ---------
  2551.  
  2552. This field shows all the groups to which this area belongs. If
  2553. you press Enter to edit this field, the line turns into a list
  2554. with not only the group letter, but also the full description.
  2555.  
  2556. To add another group, press Insert and select (with Enter) a
  2557. group from the other list that pops up. To remove the area
  2558. from a group, select the group and press the Delete key. You
  2559. can also use tagging to add or remove more than one group at a
  2560. time.
  2561.  
  2562. Subscribers
  2563. -----------
  2564.  
  2565. If you press enter on this field, you will be presented with a
  2566. list of the users connected to the area. You can use the
  2567. Insert key to add a user or the Delete key to remove a user;
  2568. you can also tag lists of users to add or remove. If you try
  2569. to remove a user, WtrConf asks you to confirm your choice.
  2570.  
  2571. If you want to add a user, WtrConf scans the configured users
  2572. and only lists the users that are allowed to connect the area.
  2573. These users must be allowed in a group that contains this
  2574. area.
  2575.  
  2576. If you are finished editing the list of subscribed users, you
  2577. can press Escape to exit the list and return to the area
  2578. screen.
  2579.  
  2580. Allow passive
  2581. -------------
  2582.  
  2583. If nobody is subscribed to an area anymore, you can let
  2584. WaterGate send a message to the provider (uplink) of the area
  2585. and have it disconnected, thereby saving you transmission
  2586. costs for an area that nobody reads.
  2587.  
  2588. If this options is set to NO, WaterGate will never disconnect
  2589. the area. This is especially useful for local messagebases.
  2590.  
  2591. WaterGate assumes that the last person connected to the area
  2592. (when everybody else has disconnected it) is the provider.
  2593. WaterGate manual                                        [page 48]
  2594.  
  2595. Passive
  2596. -------
  2597.  
  2598. This field shows the current state of the area. If it has been
  2599. disconnected from your uplink, WaterGate sets it to YES. If it
  2600. is still connected, it is on NO. You can toggle this setting
  2601. manually, but no message will be sent to your uplink. (Future
  2602. versions will do this, after asking for confirmation.)
  2603.  
  2604. Origin
  2605. ------
  2606.  
  2607. You can select which system origin line will be used for this
  2608. area. You can also select Custom and enter a special origin
  2609. line for this area in the next field.
  2610.  
  2611. The origin line is put at the bottom of a message when
  2612. WaterGate translates a message from UUCP to Fidonet, or when
  2613. it exports a message from a messagebase and no origin line is
  2614. present.
  2615.  
  2616. Custom
  2617. ------
  2618.  
  2619. You can enter a custom origin line for this area in this
  2620. field. To activate it, you also have to set the previous field
  2621. to "Custom".
  2622.  
  2623. Origin AKA
  2624. ----------
  2625.  
  2626. Every area belongs to a certain network. Here you can select
  2627. your system AKA for the network this area belongs to. When you
  2628. create a new area, the AKA is copied from the "Default origin
  2629. AKA" of the first group that includes this area. This AKA is
  2630. also put at the end of an origin line.
  2631.  
  2632. Add SEEN-BY
  2633. -----------
  2634.  
  2635. If your system has more than one AKA in a network and you want
  2636. other AKA■s to be added to the SEEN-BY list, you can select
  2637. them in this list. You have to press Enter first to see the
  2638. list. The Origin AKA for this area is always added to the
  2639. SEEN-BY line and doesn't need to be put in this list.
  2640.  
  2641. Moderated and Moderator
  2642. -----------------------
  2643.  
  2644. These two fields relate to Usenet. If an area is moderated,
  2645. then all new messages for an area have to be sent to the
  2646. moderator first. If the moderator approves the message, it is
  2647. then sent to the newsgroup.
  2648. WaterGate manual                                        [page 49]
  2649.  
  2650. If a new message arrives in a moderated area without an
  2651. ■Approved:■ header, WaterGate converts the message into a UUCP
  2652. e-mail and sends it to the moderator. If no moderator is
  2653. defined for the newsgroup, it is sent to the backbone defined
  2654. in the System configuration section, which defaults to
  2655. "berkeley.edu". For example, a message in ALT.BBS.XYZ is sent
  2656. to ALT-BBS-XYZ@Berkeley.edu.
  2657.  
  2658. If you are unsure about any of this, DON'T USE THIS OPTION;
  2659. let another system upstream take care of it. If someone you
  2660. know moderates the area, enter his address in the "Moderator"
  2661. field.
  2662.  
  2663. Fido base and path
  2664. ------------------
  2665.  
  2666. If you want all messages in the area to be put in a
  2667. messagebase as well as being passed on to subscribers, you can
  2668. select the type of the message base in the "Fido base" field
  2669. and fill in the path to the message base in "Fido path". You
  2670. can select a message base type from *.MSG, Squish, and JAM.
  2671. For a *.MSG area you need to fill in the complete directory
  2672. name; for Squish and JAM you also need to include a filename
  2673. (without extension).
  2674.  
  2675. Fido age and limit
  2676. ------------------
  2677.  
  2678. You can use WtrUtil to automatically clean the messagebases.
  2679. If certain messages are too old or there are too many messages
  2680. in an area, they can be removed automatically.
  2681.  
  2682. You can enter the maximum age of a message (in days) in the
  2683. "Fido age" field and the maximum number of messages that can
  2684. be in an area at any one time in "Fido limit".
  2685.  
  2686. Note that when there are too many message in an area, the
  2687. oldest messages are deleted first. The deletion is not
  2688. automatic: you have to use WtrUtil to remove them.
  2689.  
  2690. If you don't want to remove messages by age or limit, you can
  2691. set the field to 0.
  2692. WaterGate manual                                        [page 50]
  2693.  
  2694. Adding Users
  2695. ------------
  2696.  
  2697. A user in the WaterGate system represents a system with which
  2698. you exchange messages. There are three different types of
  2699. users:
  2700.  
  2701.    - Fidonet
  2702.    - UUCP
  2703.    - Bag supplier
  2704.  
  2705. The difference between the three users is the message
  2706. transport system. A Fidonet style user basically uses .PKT
  2707. files, a UUCP user uses the UUCP mechanism, and a Bag supplier
  2708. only sends messages to you in .BAG files, which are usually
  2709. Usenet messages received from a satellite.
  2710.  
  2711. You can add or remove users using the "User definitions"
  2712. option from the main menu. After pressing the Enter key to
  2713. select the option from the main menu, you will be presented
  2714. with a list of all the currently defined users. Depending on
  2715. their type, their UUCPname or Fido address will also be shown.
  2716.  
  2717. You can add a user by pressing the Insert key, or delete a
  2718. user by pressing the Delete key. Pressing Escape returns you
  2719. to the main menu.
  2720.  
  2721. When adding a user to your system, you are asked whether the
  2722. user is a Fidonet, UUCP, or Bag supplier style user. After
  2723. having selected the type of user, you will be presented with a
  2724. screen where you can enter all the user's settings. Since
  2725. these three screens differ quite a bit from each other, they
  2726. will be described separately.
  2727. WaterGate manual                                        [page 51]
  2728.  
  2729. Fidonet style user
  2730. ------------------
  2731.  
  2732. As stated before, a Fidonet style user exchanges mail with you
  2733. via .PKT files. These files may also be archived and
  2734. compressed.
  2735.  
  2736. Besides the normal Fidonet settings you might be used to,
  2737. WaterGate also offers the capability to let the Fidonet style
  2738. user interact with UUCP. That is, to receive and send e-mail
  2739. and read and write news. If you want this user to be able to
  2740. do that, you also have to fill in some or all of the fields
  2741. that relate to UUCP.
  2742.  
  2743. The screen to edit the settings for a Fidonet style user looks
  2744. almost like this (three lines where moved to the left to make
  2745. it fit on the page)
  2746.  
  2747.      +-[Fido style user]---------------------------------+
  2748.      | Address           2:200/112.15                    |
  2749.      | SysOp             Ramon van der Winkel            |
  2750.      | Organization      Waterline Software Development  |
  2751.      | Allowed groups    ABC           OP                |
  2752.      | Subscribed to     <press enter to see list>       |
  2753.      | AreaFix password  verysecret                      |
  2754.      | AreaFix special   NO yes                          |
  2755.      | Create new areas  NO yes                          |
  2756.      | Passive           NO yes                          |
  2757.      | PKT password      wsdpkt                          |
  2758.      | Compression       arc arj lzh pak ZIP zoo op1 pkt |
  2759.      | Send format       NORMAL hold crash direct        |
  2760.      | Max. PKT length   0                               |
  2761.      | Export AKA        Automatic                       |
  2762.      | UUCP name         wsd                             |
  2763.      | World registered  NO yes                          |
  2764.      | Allow sub-domains no YES                          |
  2765.      | Domain addresses  wsd.wline.se                    |
  2766.      |                   admin.wline.se                  |
  2767.      |                                                   |
  2768.      |                                                   |
  2769.      |                                                   |
  2770.      |                                                   |
  2771.      +---------------------------------------------------+
  2772.  
  2773. Organization
  2774. ------------
  2775.  
  2776. The Organization field is common to all users. It is used when
  2777. a UUCP message is created for the user--in this case, when a
  2778. Fidonet message is translated into a UUCP message. The
  2779. "Organization" header in that UUCP message will be filled in
  2780. with whatever you type here.
  2781.  
  2782. If you leave this line blank, no "Organization:" header will
  2783. be put in the UUCP message.
  2784. WaterGate manual                                        [page 52]
  2785.  
  2786. Allowed groups
  2787. --------------
  2788.  
  2789. This field shows you which groups this user is allowed in.
  2790. Each group can contain a number of areas, so the groups filter
  2791. effectively grants the user access to those areas. This is
  2792. used by AreaFix and WtrConf.
  2793.  
  2794. If you want to connect this user to an area, WtrConf only
  2795. shows you the areas that this user is allowed in. It is
  2796. perfectly possible, though, to connect a user to an area that
  2797. is not in one of these groups, by adding the group letter,
  2798. connecting the area and removing the group letter again.
  2799. (Future versions of WtrConf will warn you when a user is
  2800. connected to an area without being allowed in a group that
  2801. includes it.)
  2802.  
  2803. To edit the groups filter, press Enter on the field. You will
  2804. now be presented with a list of groups this user is allowed
  2805. in. You can use the Delete and Insert keys to change them.
  2806.  
  2807. Subscribed to
  2808. -------------
  2809.  
  2810. If you press Enter on this field, WtrConf will list all the
  2811. areas to which this user is connected. You can use tagging (or
  2812. not) and press the Delete key to disconnect one or more areas
  2813. for this user. If you press Insert, WtrConf will list all the
  2814. areas this user has permission to connect, but is not yet
  2815. connected to. You can again use tagging (or not) and press
  2816. Enter to connect the user to those areas. You can always press
  2817. Escape to return to the previous list, or to the edit screen.
  2818. While WtrConf is busy building the list, you can press Escape
  2819. to abort it.
  2820.  
  2821. Passive
  2822. -------
  2823.  
  2824. If a user will be going on an extended holiday, it might be
  2825. unnecessary to pack echomail for him. If you set this option
  2826. to YES, the user is considered on a holiday.
  2827.  
  2828. The user can change this option via AreaFix with the
  2829. "%PASSIVE" and "%ACTIVE" commands (for more information, see
  2830. the chapter on AreaFix).
  2831.  
  2832. Address
  2833. -------
  2834.  
  2835. Type the user■s Fidonet address here. You can use a full 5D
  2836. address, like 2:280/802.33@bananas, although less will work
  2837. perfectly fine as well. The minimum is zone, net, and node
  2838. number.
  2839. If you want the 3D point address to be put in the archives
  2840. that are created for this user, you have to define the user
  2841. with the pointnet, instead of the full address!
  2842. WaterGate manual                                        [page 53]
  2843.  
  2844. SysOp
  2845. -----
  2846.  
  2847. Enter the full name of the SysOp at this address here. If
  2848. WaterGate wants to report special things to that site, it will
  2849. use this name in the To: field of the Fidonet message.
  2850.  
  2851. Packet password
  2852. ---------------
  2853.  
  2854. To increase security, you can enter a packet password in this
  2855. field. It will be put in the outgoing packets that are sent to
  2856. this user and, if "inbound security" is switched on, WaterGate
  2857. will also check that packets from this user contain the
  2858. correct password as well.
  2859.  
  2860. If the packet password is wrong, the packet is renamed to .PWD
  2861. and a line is written to the logfile with both the expected
  2862. and found passwords.
  2863.  
  2864. AreaFix password
  2865. ----------------
  2866.  
  2867. AreaFix is a very powerful tool users can use to change
  2868. settings or to (dis)connect areas. To make sure an authorised
  2869. user is using it, a password is required. You can enter this
  2870. password here. If you want to block somebody from using
  2871. AreaFix, you can type something funny here.
  2872.  
  2873. AreaFix special
  2874. ---------------
  2875.  
  2876. You can set this option to YES for co-sysops. They will then
  2877. be allowed to change their identify in AreaFix with the %FROM
  2878. command and change settings for other users. This option is
  2879. currently disabled in AreaFix (version 0.18) because of a
  2880. rewrite of the AreaFix code.
  2881.  
  2882. There are some other maintenance commands in AreaFix that are
  2883. enabled for users with this option set to YES. See the AreaFix
  2884. chapter for more details.
  2885.  
  2886. Please be very careful with this option, because it can be a
  2887. big security gap if it is set to YES for the wrong person!
  2888.  
  2889. New Area-create
  2890. ---------------
  2891.  
  2892. To save yourself a lot of typing, you can tell WaterGate to
  2893. automatically create a new area when this user sends you a
  2894. message in an area that is not yet present on your system.
  2895. This new area will always be created in Group Z. You can then
  2896. move the area to another group to allow other users to connect
  2897. the area.
  2898. WaterGate manual                                        [page 54]
  2899.  
  2900. It is more than useful to enable this option for your uplink
  2901. systems, because new areas will be created as soon as a
  2902. message is received in them. If you also enable the automatic
  2903. creation of a message base, you won't miss a message.
  2904.  
  2905. Be aware that this can create a lot of new areas when you
  2906. enable this for your UUCP uplink. See the NEWSFILTER option of
  2907. the ROUTE.TDB file for a solution.
  2908.  
  2909. Compression
  2910. -----------
  2911.  
  2912. This setting selects the way one or more .PKT files are
  2913. archived in the outbound directory. The first six options
  2914. speak for themselves. The option OP1 is your custom defined
  2915. archiver and if you set it to PKT, the .PKT will not be
  2916. archived.
  2917.  
  2918. Send format
  2919. -----------
  2920.  
  2921. There are different priorities for delivery of an archive to a
  2922. system. You can select a priority in this field:
  2923.  
  2924. Normal    If you regularly call this node, set it to Normal.
  2925. The archive will be sent when you call this system or this
  2926. system calls you.
  2927.  
  2928. Hold      Hold for Pickup. If you set it to this option, this
  2929.           system must call you to pick up the archive.
  2930.  
  2931. Crash     If you want your mailer to call this system as soon
  2932.           as a new archive has been created, set it to this
  2933.           option.
  2934.  
  2935. Direct    If you set it to this option, you don't want to
  2936.           route this mail bundle via another node.
  2937.  
  2938. Of course, you will have to configure the way your mailer
  2939. software (such as FrontDoor) responds to these flags.
  2940.  
  2941. Max PKT length
  2942. --------------
  2943.  
  2944. It is possible to limit the size of a .PKT file. WaterGate
  2945. checks the length of the .PKT after writing a message to it.
  2946. If the size of the .PKT is bigger than this value, the .PKT
  2947. file is closed and a new .PKT will be started. You can disable
  2948. this option by setting it to 0.
  2949.  
  2950. UUCP name
  2951. ---------
  2952.  
  2953. This field and the following three fields all relate to the
  2954. UUCP side of this user. You might not need these.
  2955. WaterGate manual                                        [page 55]
  2956.  
  2957. The UUCPname is the name of this system. The name can be 12
  2958. characters long, but only the first seven characters are used.
  2959. You must fill in this field if this system will be involved in
  2960. UUCP, because all UUCP actions are based upon this name. The
  2961. name must be unique within your system.
  2962.  
  2963. Domain addresses
  2964. ----------------
  2965.  
  2966. Apart from a UUCPname, the system must have one or more domain
  2967. addresses as well. The first domain address is the most
  2968. important one and WaterGate uses it when it has to have a
  2969. domain address for this user. The other five addresses you can
  2970. enter here are just aliases. If five are not enough, you can
  2971. also use ROUTE-UUCP statements in the ROUTE.TDB file.
  2972.  
  2973. World Registered
  2974. ----------------
  2975.  
  2976. If the UUCPname entered above is World Wide Registered, you
  2977. are allowed to use it in addresses. If this is not the case
  2978. (most likely!), then leave it at NO. If you set it to YES,
  2979. WaterGate will use the UUCPname in the From and Path: header
  2980. lines.
  2981.  
  2982. Allow sub-domains
  2983. -----------------
  2984.  
  2985. If you want a user to be able to define sub-domains of his own
  2986. domain, you need to set the 'Allow sub-domains' switch to YES.
  2987. By doing so, you allow a user to process mail for his own set
  2988. of systems.
  2989.  
  2990. If you set this option to NO, WaterGate will only send
  2991. messages to this system that are addressed to one of its
  2992. domain addresses (or to its UUCPname, if it is world
  2993. registered).
  2994.  
  2995. If you set this option to YES, WaterGate will also route
  2996. messages for sub-domains of this system. This has the same
  2997. functionality as adding the following line to your ROUTE.TDB
  2998. file (example for the wsd system):
  2999.  
  3000.      ROUTE-UUCP .wsd.wlink.nl wsd
  3001.  
  3002. Notice the dot in front of the domain name. As you can see,
  3003. the last part of this line is the UUCPname. That is why it is
  3004. so important to set the UUCPname.
  3005.  
  3006. You can also just add the domain address with the dot in front
  3007. in the domain addresses list. This or a ROUTE-UUCP statement
  3008. makes the switch useless! Future versions of WaterGate will
  3009. also block messages from this system if this switch is set to
  3010. NO.
  3011. WaterGate manual                                        [page 56]
  3012.  
  3013. UUCP style user
  3014. ---------------
  3015.  
  3016. A UUCP style user is a system with which you exchange messages
  3017. via the UUCP protocol. You need a program like Waffle's UUCICO
  3018. or the FX-UUCICO program to transfer the files. These files
  3019. are set up in the spool directory structure, where every
  3020. system has its own sub-directory named after its UUCPname.
  3021.  
  3022.      +-[UUCP style user]---------------------------+
  3023.      | Organization      CyberSpace AB             |
  3024.      | Allowed groups    AB       JKL              |
  3025.      | Subscribed to     <press enter to see list> |
  3026.      | Passive           NO yes                    |
  3027.      | NewsFix password  verysecret                |
  3028.      | NewsFix special   NO yes                    |
  3029.      | New Area-create   NO yes                    |
  3030.      | Compress          none compress ZIP         |
  3031.      | Add batch header  no YES                    |
  3032.      | UUCP name         cyber                     |
  3033.      | World registered  NO yes                    |
  3034.      | Allow sub-domains NO yes                    |
  3035.      | Domain addresses  cyberspace.wline.se       |
  3036.      |                                             |
  3037.      |                                             |
  3038.      |                                             |
  3039.      |                                             |
  3040.      |                                             |
  3041.      +---------------------------------------------+
  3042.  
  3043. Most of these fields have been described in the "Fidonet style
  3044. user" chapter. The NewsFix system is the same as the AreaFix
  3045. system with a different name, but it lists the UUCP name of
  3046. the area.
  3047.  
  3048. The only two new fields are:
  3049.  
  3050. Compress
  3051. --------
  3052.  
  3053. With this option you select how the news bundles (.DAT files
  3054. in the spool directory) have to be archived, if at all. Mail
  3055. bundles (also .DAT files) are never archived.
  3056.  
  3057. You can choose between the older COMPRESS or the newer ZIP
  3058. (better know as GZIP, don't confuse it with PkZip!).
  3059.  
  3060. The setting of this switch is not important for extracting the
  3061. archives in the spool directory. WaterGate uses a detection
  3062. mechanism for that.
  3063. WaterGate manual                                        [page 57]
  3064.  
  3065. Add batch header
  3066. ----------------
  3067.  
  3068. The batch header is a special header that can be added for
  3069. UNIX systems, so they can easily find out that the .DAT file
  3070. is compressed. 
  3071.  
  3072. WaterGate will add the header "cunbatch" for compressed file
  3073. and "gunbatch" for G-zipped files. It is possible to override
  3074. this with the GZIPBATCH statement in the ROUTE.TDB file, so
  3075. you can set it to "zunbatch" for GZip compressed news batches.
  3076.  
  3077. For reliability issues, it is better not to set any header at
  3078. all, or mayby not even compress news batches at all (V42.bis
  3079. modems will compress it for you anyway). Certainly not towards
  3080. your uplink UUCP system. It is very easy to find problems
  3081. between you and your downlinks, but not with your uplink.
  3082.  
  3083.  
  3084. Remark on the use of "New Area-create"
  3085. --------------------------------------
  3086.  
  3087. If you enable "New Area-create" for UUCP systems, WaterGate
  3088. will create a new area as soon as it receives a message in a
  3089. non-existent newsgroup.
  3090.  
  3091. But, since so many messages on UUCP are crossposted, WaterGate
  3092. checks for the existence of all the areas to which the message
  3093. was crossposted. If they don't exist, it creates the area.
  3094.  
  3095. Unfortunately, messages are not only crossposted in the
  3096. publicly know newsgroups, but sometimes also in local
  3097. newsgroups. This means that you might end up with an area with
  3098. a name like "buro.general".
  3099.  
  3100. WaterGate enables you to avoid the areas like "buro.general"
  3101. by installing a proper "New Newsgroup Names Filter File". This
  3102. will be described later in more detail, but this file
  3103. basically consists of the newsgroup names that you do want to
  3104. have created, or the first part of that newsgroup name, for
  3105. example:
  3106.  
  3107.      alt.
  3108.      comp.
  3109.      rec.
  3110.  
  3111. The file is more powerful, so a separate chapter will explain
  3112. this in more detail.
  3113. WaterGate manual                                        [page 58]
  3114.  
  3115. Bag supplier
  3116. ------------
  3117.  
  3118. A BAG supplier is a system that creates files with the names
  3119. NEWS0001.BAG, NEWS0002.BAG, etc. These files are just like
  3120. UUCP .D files.
  3121.  
  3122. They are used with systems that receive their Usenet news via
  3123. a satellite link. It is possible to receive up to 600+
  3124. megabytes per day of news, without telephone costs!
  3125.  
  3126.      +-[BAG supplier]---------------------------------------+
  3127.      | Organization      WSD brings you news from a dish!   |
  3128.      | Allowed groups    A                                  |
  3129.      | Subscribed to     <press enter to see list>          |
  3130.      | New Area-create   no YES                             |
  3131.      | Return system     wtrlnd                             |
  3132.      | UUCP name         satdish                            |
  3133.      | World Registered  NO yes                             |
  3134.      | Allow sub-domains NO yes                             |
  3135.      | Domain addresses  satdish.wsd.wlink.nl               |
  3136.      |                                                      |
  3137.      |                                                      |
  3138.      |                                                      |
  3139.      |                                                      |
  3140.      |                                                      |
  3141.      +------------------------------------------------------+
  3142.  
  3143. All fields in this screen have already been described in
  3144. "Fidonet style user" and "UUCP style user". The only new field
  3145. in this screen is the Return system.
  3146.  
  3147. Return system
  3148. -------------
  3149.  
  3150. Because the BAG system can only be used to receive messages,
  3151. there has be a way to send messages back to the network. This
  3152. is done via the "Return system". If a message is destined for
  3153. the BAG system, it is sent to the Return System instead.
  3154.  
  3155. You have to create the return system as a user of a system and
  3156. enter the UUCPname of that system in this field.
  3157.  
  3158. Why it works like this is because of the basic way WaterGate
  3159. uses to distribute messages. When somebody posts a messages in
  3160. an area, everybody connected to that area receives the
  3161. message. To be able to post in an area, you have to be
  3162. connected to it. So, the BAG system has to be connected to the
  3163. area in order to deliver messages. But postings from other
  3164. users will then be sent back. The return system user is used
  3165. to send messages back to the real system, in stead of via the
  3166. satellite.
  3167. WaterGate manual                                        [page 59]
  3168.  
  3169. WARNING about the return system
  3170. -------------------------------
  3171.  
  3172. The return system MUST NOT be connected to all the areas. If
  3173. you do this, the return system will receive the entire feed
  3174. from the BAG supplier. And since this return system is usually
  3175. your real UUCP uplink, they probably won■t take kindly to
  3176. receiving all this news from you as well. You might create a
  3177. nice duplicate loop if you do this wrong, and that might be
  3178. disastrous! So, be careful!
  3179. WaterGate manual                                        [page 60]
  3180.  
  3181. The List Server
  3182. ---------------
  3183.  
  3184. The List Server is an automatic message distribution part of
  3185. WaterGate that handles mailing lists. A mailing list is a list
  3186. of e-mail and netmail addresses of people that are interested
  3187. in that particular mailing list. If a message is distributed
  3188. by the list server, everybody on that list receives a copy of
  3189. the message.
  3190.  
  3191. So, you can see a mailing list as a more private echomail area
  3192. or newsgroup. The advantage is that all the intermediate
  3193. systems don't need to define that particular echo or
  3194. newsgroup, and users who can receive mail but not news can
  3195. also participate. WaterGate can handle up to 65000+ mailing
  3196. lists.
  3197.  
  3198. The biggest advantage of mailing lists is the control of who
  3199. can posts messages to it and not having to read all the spam
  3200. postings that you find in the newsgroups nowadays.
  3201.  
  3202. Subscribing to a mailing list
  3203. -----------------------------
  3204.  
  3205. To subscribe to a mailing list, a user has to send a message
  3206. to the list server, which can be addressed as "listserv" or
  3207. "listserver", at any of your system AKAs or at any of your
  3208. system domain addresses, for example:
  3209.  
  3210.      ListServer at 2:280/803
  3211. or
  3212.      listserver@wsd.wlink.nl
  3213.  
  3214. You can request the list server to perform certain actions for
  3215. you, just like AreaFix. It doesn't matter if you send a
  3216. message to the list server via e-mail or via netmail. You use
  3217. the same commands and you put them in the body of the message.
  3218. The end of the message is indicated by a tear-line, so don't
  3219. put any other lines in the message, like "Hi!" or "Bye,",
  3220. because the list server will try to interpret them as
  3221. commands.
  3222.  
  3223. The following commands are available:
  3224.  
  3225. LIST      Request the list server to send a list of all
  3226.           possible mailing lists available at this system.
  3227.  
  3228. HELP      Ask the list server to send you information on using
  3229.           the list server. This information is also sent
  3230.           automatically if a user sends an unknown command (or
  3231.           something like "Hi!").
  3232.  
  3233. (continued on the next page)
  3234. WaterGate manual                                        [page 61]
  3235.  
  3236. CONNECT listname
  3237. SUBSCRIBE listname       Two commands that both put the
  3238.                          sender's address on the requested
  3239.                          mailing list.
  3240.  
  3241. DISCONNECT listname
  3242. UNSUBSCRIBE listname     Two commands that remove the sender's
  3243.                          address from the requested mailing
  3244.                          list.
  3245.  
  3246. Notice that the sender's address, or more accurately the reply
  3247. address, is very important for the list server, as it is put
  3248. on the mailing list! This is especially important for a UUCP
  3249. e-mail message, which has to have a proper Reply-To:, Sender:,
  3250. or From: header (in that order).
  3251.  
  3252. As soon as a user receives a reply from the list server
  3253. indicating that he has been put on the list, he can send a
  3254. message to the mailing list to have it distributed. Since your
  3255. system might have more than one mailing list, the message must
  3256. be sent to the name of the mailing list, on one of your system
  3257. AKAs or system domain addresses, for example:
  3258.  
  3259.      WaterGate@wsd.wlink.nl
  3260. or
  3261.      WaterGate at 2:280/803
  3262.  
  3263. Names of mailing lists are commonly given the extension -L, to
  3264. indicate that it is a mailing list and not a normal user. Our
  3265. own mailing list doesn't have a name like that yet, but if it
  3266. did, the name would be WaterGate-l@wsd.wlink.nl.
  3267.  
  3268. Notice that you MUST NOT put the domain address in the name of
  3269. the mailing list. Just "WaterGate-L" is all you have to enter.
  3270. The first system domain address is added automatically.
  3271.  
  3272. Setting up a mailing list
  3273. -------------------------
  3274.  
  3275. To create your own mailing list, select the "Mailing list
  3276. definitions" option from WtrConf's main menu. The names of all
  3277. the mailing lists that are currently defined on your system
  3278. will then be listed.
  3279.  
  3280. You can add a list by pressing the Insert key, or remove a
  3281. list by pressing the Delete key. The Escape key returns you to
  3282. the main menu. If you want to edit a mailing list definition,
  3283. you have to press the Enter key.
  3284. WaterGate manual                                        [page 62]
  3285.  
  3286. When editing a (new) mailing list definition, the following
  3287. screen is used:
  3288.  
  3289.      +-----------------------------------------------+
  3290.      | List name   : WaterGate                       |
  3291.      | Description : WaterGate Support mailing list  |
  3292.      | Welcome file: c:\wsd\wtrgate\wg_hej.txt       |
  3293.      | Private list: yes NO                          |
  3294.      | Only Known  : yes NO                          |
  3295.      | Active      : YES no                          |
  3296.      | AKA         : 2:280/803                       |
  3297.      |                                               |
  3298.      | Area name   : WLINK.WATERGATE                 |
  3299.      | Echo to List: YES no                          |
  3300.      | List to Echo: YES no                          |
  3301.      |                                               |
  3302.      | Subscribers : <enter to edit>                 |
  3303.      +-----------------------------------------------+
  3304.  
  3305. List name
  3306. ---------
  3307.  
  3308. Enter the name of the mailing list here. This name has to be
  3309. unique on your system, so make sure there are no users with
  3310. the same name! You might want to put -L at the end of the
  3311. name, to indicate that it is a mailing list and reduce the
  3312. chance of it being the same as a user's e-mail address.
  3313.  
  3314. You MUST NOT type in a domain address here. The first system
  3315. domain address is added automatically when sending to a UUCP
  3316. system. Remember that the mailing list is accessable from
  3317. within Fidonet as well, so don't type in a domain address!!
  3318.  
  3319. Description
  3320. -----------
  3321.  
  3322. You can use the description line to describe this mailing
  3323. list. This line is used in the lists the list server sends in
  3324. response to the LIST command.
  3325.  
  3326. Welcome file
  3327. ------------
  3328.  
  3329. The welcome file is sent when someone connects to this list.
  3330. It should contain some information about the mailing list: the
  3331. purpose, the language to use, and how to disconnect from it.
  3332. The welcome file is a normal ASCII textfile and can contain
  3333. tokens, just like the AreaFix and newsfix .TXT files. See the
  3334. chapter "Installing the .TXT files" and appendix A for more
  3335. information on tokens.
  3336. WaterGate manual                                        [page 63]
  3337.  
  3338. Private list
  3339. ------------
  3340.  
  3341. This toggle defines whether the list is private or not.
  3342. Private lists do not show up in the list of public mailing
  3343. lists that people can connect to using the list server. You
  3344. have to maintain (connect/disconnect people) private lists
  3345. manually.
  3346.  
  3347. Only known
  3348. ----------
  3349.  
  3350. If you set this toggle to YES, only systems that are defined
  3351. in your userbase can connect to the list. This is a middle way
  3352. between public access (Private list to NO) and complete manual
  3353. access (Private list to YES).
  3354.  
  3355. Active
  3356. ------
  3357.  
  3358. This toggle determines whether this list is currently active.
  3359. A disabled list is completely ignored and hidden by your
  3360. system.
  3361. It won't show up in the lists and users can neither connect to
  3362. nor disconnect from it.
  3363.  
  3364. AKA
  3365. ---
  3366.  
  3367. Select a system AKA for messages sent into Fidonet. This AKA
  3368. is used as a From address for all messages sent by this list.
  3369.  
  3370. This will be changed in a future release, because the List
  3371. Server is addressable on all your system AKAs. It will then
  3372. use the most closely matching system AKA when replying to the
  3373. message sender. This AKA will then be used when a message is
  3374. sent to the list from UUCP and has to be translated to
  3375. Fidonet. It is currently also used when a message is
  3376. translated to an echomail message, but that will change also,
  3377. since areas have an Origin AKA.
  3378. WaterGate manual                                        [page 64]
  3379.  
  3380. Area name
  3381. ---------
  3382.  
  3383. It is possible to connect a mailing list to an echomail area.
  3384. This gives you several extra abilities, such as connecting a
  3385. messagebase to a mailing list.
  3386.  
  3387. Echo to list
  3388. ------------
  3389.  
  3390. This toggle determines whether WaterGate allows message that
  3391. were written in the area (or messagebase) to be sent out on
  3392. the mailing list.
  3393.  
  3394. List to echo
  3395. ------------
  3396.  
  3397. If you set this option to YES, WaterGate will copy all the
  3398. messages that were distributed via the mailing list to the
  3399. area as well (and into the messagebase, if it is connected to
  3400. one).
  3401.  
  3402. Subscribers
  3403. -----------
  3404.  
  3405. If you press Enter on this field, you will be presented with a
  3406. list of addresses of all the users that are currently
  3407. connected to this mailing list. You can edit the list manually
  3408. with the Insert, Delete, and Enter keys.
  3409.  
  3410. WaterGate differentiates between UUCP and Fidonet users. UUCP
  3411. users need an e-mail address; Fidonet users need a full name
  3412. and an AKA.
  3413.  
  3414. Forwarding a mailing list you receive into an area
  3415. --------------------------------------------------
  3416.  
  3417. Some people are connected to one or more mailing lists and
  3418. want the messages that are received from that mailing list to
  3419. end up in an echomail area, so people can read it on a BBS,
  3420. for example.
  3421.  
  3422. To do this, you will set up an mailing list and an area and
  3423. connect the two. All messages received from the mailing list
  3424. go into your own mailing list and are distributed there. You
  3425. don't connect anybody, but just link it to the area.
  3426.  
  3427. There are two ways to get this two work. The first way is to
  3428. create a mailing list with the same name you receive the
  3429. messages as. The second is to create whatever mailing list
  3430. name you like and use a MAP-UUCP statement to map the incoming
  3431. messages to the mailing list name. Both are explained below.
  3432.  
  3433. In our example, we are receiving messages as from the mailing
  3434. list daily-weather@seismic.com and we have subscribed as
  3435. daily-weather@wsd.wline.se. If you have subscribed using your
  3436. normal e-mail address, then you are in trouble, because it is
  3437. not possible to extract the mailing list messages from your
  3438. WaterGate manual                                        [page 65]
  3439.  
  3440. normal mail flow. You will have to change the e-mail address
  3441. you receive your messages at.
  3442.  
  3443. We want to get these messages into an area which we have
  3444. created, called DAILY_WEATHER.
  3445.  
  3446. The first step is to create a new mailing list. Go to the
  3447. Mailing List definitions in WtrConf and press the Insert key
  3448. to add a new mailing list. Give it the name "daily-weather".
  3449. We now have a mailing list that is connected to the e-mail
  3450. address
  3451. daily-weather@one-of-your-system-domain-addresses, where the
  3452. part after the @ can be any of your system domain addresses.
  3453. In my case wsd.wline.se.
  3454.  
  3455. All we have to do now is link the mailing list to the area.
  3456. Type in the name of the area in the "Area name" field. In our
  3457. example DAILY_WEATHER. Then set "List to echo" to YES and you
  3458. are done.
  3459.  
  3460. In the case where you receive the messages from the mailing
  3461. list with an different address as then name you want to use
  3462. for your mailing list, then simply add a MAP-UUCP statement to
  3463. the ROUTE.TDB file that translates the incoming e-mail address
  3464. and changes it into an other.
  3465.  
  3466. For example, you receive the messages as "dailyrain" and you
  3467. want to call your mailing list "daily-weather", then use the
  3468. following mapping statement:
  3469.  
  3470.      MAP-UUCP dailyrain daily-weather
  3471.  
  3472. And you are done.
  3473.  
  3474. Leave the option "Echo to list" to NO, or messages posting in
  3475. the area will be sent to the mailing list! And if you don't
  3476. want anybody else to connect to the mailing list using the
  3477. list server, then set "Allow remote" to NO.
  3478. WaterGate manual                                        [page 66]
  3479.  
  3480. The Gateway
  3481. -----------
  3482.  
  3483. This chapter describes the operation and use of the gateway.
  3484. The chapter "Gateway settings" (loads of pages back) describes
  3485. how to configure it.
  3486.  
  3487. The gateway is where messages are translated between the
  3488. Fidonet and UUCP formats. There are different gateways for the
  3489. echomail<->news translation and the netmail<->mail
  3490. translation.
  3491.  
  3492. The echomail<->news gateway
  3493. ---------------------------
  3494.  
  3495. This gateway is used automatically when a message is sent in
  3496. an area from the Fidonet side and a UUCP style user is also
  3497. connected to that area; or the other way around, when a
  3498. message is sent to an area from the UUCP side and a Fidonet
  3499. style user is connected to the area.
  3500.  
  3501. The message is then translated into the other format and sent
  3502. out. When distributing a message in an area, the message is
  3503. first sent to all connected users in the same style and if any
  3504. users in the other style were found, the message is translated
  3505. and then sent to all those users.
  3506.  
  3507. Gating echomail to news
  3508. -----------------------
  3509.  
  3510. When an echomail message is translated to a news message, a
  3511. number of actions are performed on the message. For example,
  3512. all the kludge lines are removed, the high-ASCII values in the
  3513. body of the message are translated using the ASCII conversion
  3514. table, the date format is converted and the day-of-the-week
  3515. and a time-zone are added, all addresses are translated, a
  3516. valid UUCP header is put at the beginning of the message, the
  3517. tear-line, origin-line, PATH and SEEN-BY lines are removed,
  3518. and a signature might be added.
  3519.  
  3520. Gating news to echomail
  3521. -----------------------
  3522.  
  3523. When a news message has to be translated to an echomail
  3524. message, a number of actions are performed on the message. Not
  3525. as much as when translating in the other direction, but in
  3526. short the header lines are removed or copied to the fido
  3527. message as kludge lines or body text, the date format is
  3528. converted, the addresses are converted, the body text is
  3529. copied without change, special kludge lines are added, and a
  3530. tear-line, origin line, PATH line, and SEEN-BY line are added.
  3531.  
  3532. What is important to know about this gateway is that it works
  3533. automatically when it has to be used.
  3534. WaterGate manual                                        [page 67]
  3535.  
  3536. The netmail<->mail gateway
  3537. --------------------------
  3538.  
  3539. This gateway handles the translation between the Fidonet
  3540. netmail style of messages and UUCP style mail messages. The
  3541. translation is more complex than the echomail<->news
  3542. translation.
  3543.  
  3544. What is important to know about this gateway is that it does
  3545. not always work automatically. If you use certain settings and
  3546. addressing formats, it works automatically. If you don't use
  3547. them, you have to send your messages to a specific address and
  3548. username to have it translated.
  3549.  
  3550. Using the gateway with netmail
  3551. ------------------------------
  3552.  
  3553. If you are on Fidonet and you want to send a message to
  3554. someone via UUCP, you have to know the address. Say that I am
  3555. "Ramon van der Winkel" at 2:280/802.33 and I want to send a
  3556. message to martijn@dijkline.wlink.nl. I will have to write a
  3557. netmail message; it is then sent to the gateway (WaterGate),
  3558. which translates it and forms it into a mail message, and then
  3559. it is sent out on the UUCP side.
  3560.  
  3561. You can put the UUCP address in the To: field of the netmail
  3562. message. WaterGate will recognize it as a UUCP address and
  3563. then automatically gate the message. The "Gateway TO:" option
  3564. has to be set to YES to enable this.
  3565.  
  3566. There are occasions when the complete UUCP address does not
  3567. fit in the To: field, for example when using QWK, which has a
  3568. shorter To: field, or when the address is simply too long. In
  3569. that case, you have to send the netmail to the WaterGate
  3570. program and put the UUCP address on the first line of the body
  3571. of the message, preceded by "To:", like this:
  3572.  
  3573.      To: martijn@dijkline.wlink.nl.
  3574.  
  3575. The AKA to which the netmail must be addressed is set in the
  3576. Gateway Settings screen. The first field contains the AKA you
  3577. want to use for the gateway. The second field holds the name
  3578. of the user to which the netmail should be addressed. This
  3579. defaults to "UUCP" and your first system AKA.
  3580.  
  3581. To return to the example above, the complete netmail message
  3582. header would then be:
  3583.  
  3584. From: Ramon van der Winkel         2:280/802.33
  3585. To:   UUCP                         44:230/40
  3586. Subj: Test
  3587. ---------------------------------------------------------
  3588. TO: martijn@dijkline.wlink.nl
  3589.  
  3590. Hi Dijk!
  3591. ...
  3592. WaterGate manual                                        [page 68]
  3593.  
  3594. The name "UUCP" and the AKA are configured like this in the
  3595. Gateway settings screen.
  3596.  
  3597. If the UUCP address fits in the To: field, I still have to put
  3598. in the AKA of the gateway (44:230/40 in this example). The
  3599. netmail would then look like this:
  3600.  
  3601. From: Ramon van der Winkel         2:280/802.33
  3602. To:   martijn@dijkline.wlink.nl    44:230/40
  3603. Subj: Test
  3604. ---------------------------------------------------------
  3605. Hi Dijk!
  3606. ...
  3607.  
  3608. Fidonet address to e-mail address translation
  3609. ---------------------------------------------
  3610.  
  3611. When a message is translated by the gateway, the Fidonet
  3612. address of the sender of the message must be translated to a
  3613. valid UUCP address.
  3614.  
  3615. Remember that a Fidonet address consists of the full name of
  3616. the user (for example "Ramon van der Winkel") and an Fidonet
  3617. address, also known as an AKA (for example 2:280/802.33).
  3618.  
  3619. The UUCP address consists of two parts: the username (for
  3620. example "ramon") and the domain part (for example
  3621. "wsd.wlink.nl"), which are added together to form the full e-
  3622. mail address user@domain (for example ramon@wsd.wlink.nl).
  3623.  
  3624. When a netmail is received at your system that has to be
  3625. gated, there are five possible situations:
  3626.  
  3627. 1 -  The user and his AKA are both unknown to your system.
  3628.  
  3629. 2 -  A Fidonet style user record exists for this AKA, without
  3630.      the UUCPname and domain addresses filled in. The full
  3631.      name of the user does not matter.
  3632.  
  3633. 3 -  A Fidonet style user record exists for this AKA, with the
  3634.      UUCPname and domain addresses filled in. The full name of
  3635.      the user does not matter.
  3636.  
  3637. 4 -  A mapping statement exists in the ROUTE.TDB file for this
  3638.      AKA. The full name of the user does not matter.
  3639.  
  3640. 5 -  A mapping statement exists in the ROUTE.TDB file for this
  3641.      AKA and this particular full name.
  3642.  
  3643. Each of these situations will be described below, with
  3644. examples of the e-mail address. Remember that the most
  3645. important thing about the e-mail address is that it can be
  3646. used to reply to the message. When somebody replies to the
  3647. message, then all the required information has to be available
  3648. in the UUCP address to translate it back to the full Fidonet
  3649. address and user name.
  3650. WaterGate manual                                        [page 69]
  3651.  
  3652. Unknown AKA and full name
  3653. -------------------------
  3654.  
  3655. If the fido user is not known to your system, or in other
  3656. words, there is no fido style user in your database with this
  3657. AKA and there is no mapping statement in your ROUTE.TDB file,
  3658. then WaterGate uses the most ugly form possible for the e-mail
  3659. address.
  3660.  
  3661. The full name and the AKA of this user have to be reflected in
  3662. the e-mail address. For example:
  3663.  
  3664. ---------------------------------------------------------
  3665. Gateway AKA:                  2:280/802
  3666. 1st system domain address:    wsd.wlink.nl
  3667.  
  3668. Full name:                    Ramon van der Winkel
  3669. AKA:                          2:512/10.5
  3670.  
  3671. After translation:
  3672.  
  3673.      Ramon_van_der_Winkel@z2.n512.f10.p5.wsd.wlink.nl
  3674.  
  3675. Or with small addresses set to YES:
  3676.  
  3677.      Ramon_van_der_Winkel@n512.f10.p5.wsd.wlink.nl
  3678. ---------------------------------------------------------
  3679.      
  3680. User record, without domain address
  3681. -----------------------------------
  3682.  
  3683. If the AKA of the sending user is present in your userbase,
  3684. that is, the user has sent the message from one of your
  3685. neighboring systems, for example a point or node, but this
  3686. record has no UUCPname and domain address, then the
  3687. translation is just like the first situation, in which the
  3688. user was not known to your system at all.
  3689.  
  3690. ---------------------------------------------------------
  3691. Gateway AKA:                  2:280/802
  3692. 1st system domain address:    wsd.wlink.nl
  3693.  
  3694. Full name:                    Ramon van der Winkel
  3695. AKA:                          2:280/801
  3696.  
  3697. After translation:
  3698.  
  3699.      Ramon_van_der_Winkel@z2.n280.f801.wsd.wlink.nl
  3700.  
  3701. Or with small addresses set to YES:
  3702.  
  3703.      Ramon_van_der_Winkel@f801.wsd.wlink.nl
  3704. ---------------------------------------------------------
  3705. WaterGate manual                                        [page 70]
  3706.  
  3707. The only difference is that the address of the user is
  3708. probably closer to your address, because it is one of your
  3709. neighbor systems. This can shorten the e-mail address.
  3710.  
  3711. User record with domain address
  3712. -------------------------------
  3713.  
  3714. In this case, a record exists in your userbase with the
  3715. sending user's AKA, and you have defined a UUCPname and domain
  3716. address for this user.
  3717.  
  3718. This improves the translation, because the AKA does not have
  3719. to be put in the domain address anymore. The domain address
  3720. from the user record is used instead.
  3721.  
  3722. Some examples:
  3723. ---------------------------------------------------------
  3724. Gateway AKA:                  2:280/802
  3725. 1st system domain address:    wlink.nl
  3726.  
  3727. Full name:                    Ramon van der Winkel
  3728. AKA:                          2:280/803.33
  3729. Domain address:               wsd.wlink.nl
  3730.  
  3731. After translation:
  3732.  
  3733.      Ramon_van_der_Winkel@wsd.wlink.nl
  3734. ---------------------------------------------------------
  3735.  
  3736. The same situation occurs when a local netmail is created with
  3737. one of the system AKAs. WaterGate then uses the first system
  3738. domain address. For example:
  3739.  
  3740. ---------------------------------------------------------
  3741. Gateway AKA:                  2:280/802
  3742. 1st system domain address:    wlink.nl
  3743.  
  3744. Full name:                    Ramon van der Winkel
  3745. AKA:                          2:280/802
  3746.  
  3747. After translation:
  3748.  
  3749.      Ramon_van_der_Winkel@wlink.nl
  3750. ---------------------------------------------------------
  3751.  
  3752. Notice that the only "ugly" thing about this address is the
  3753. full name that has been translated. It is perfectly possible
  3754. to use a full name like "ramon", though, instead of "Ramon van
  3755. der Winkel".
  3756. WaterGate manual                                        [page 71]
  3757.  
  3758. Mapping statement, without full name
  3759. ------------------------------------
  3760.  
  3761. In this fourth situation it doesn't matter whether the user is
  3762. known to your system. A MAP-UUCP statement in the ROUTE.TDB
  3763. file tells WaterGate to translate the AKA to a domain address,
  3764. just as if a user record existed with the UUCPname and domain
  3765. addresses filled in.
  3766.  
  3767. This should be used for non-neighboring systems that you want
  3768. to give special domain addresses for use in UUCP. Don't put
  3769. bangpaths in the MAP-UUCP statements!
  3770.  
  3771. Example:
  3772. ---------------------------------------------------------
  3773. Full name:                    Ramon van der Winkel
  3774. AKA:                          2:512/10.5
  3775.  
  3776. Mapping statement in the ROUTE.TDB file:
  3777.  
  3778.      MAP-UUCP faraway.wsd.wlink.nl 2:512/10.5
  3779.  
  3780. After translation:
  3781.  
  3782.      Ramon_van_der_Winkel@faraway.wsd.wlink.nl
  3783. ---------------------------------------------------------
  3784.  
  3785. Notice that the gateway AKA is no longer important for the
  3786. address translation, and neither is the system domain address.
  3787. The netmail still has to be sent to the gateway AKA, of
  3788. course.
  3789. WaterGate manual                                        [page 72]
  3790.  
  3791. Mapping statement, with full name
  3792. ---------------------------------
  3793.  
  3794. All the examples up to now still had the original full name of
  3795. the sender of the message as the user name of the e-mail
  3796. address. This can be changed by using an extended MAP-UUCP
  3797. statement in ROUTE.TDB.
  3798.  
  3799. Notice that it is not possible to use a MAP-FIDO statement to
  3800. change the name of the sender, because MAP-FIDO statements
  3801. only work on To: fields of a netmail message, not From:
  3802. fields.
  3803.  
  3804. The extended MAP-UUCP mapping is actually the most common way
  3805. to give a Fidonet user an e-mail address. An example follows:
  3806.  
  3807. ---------------------------------------------------------
  3808. Full name:                    Ramon van der Winkel
  3809. AKA:                          2:512/10.5
  3810.  
  3811. Mapping statement in the ROUTE.TDB file:
  3812.  
  3813. MAP-UUCP ramon@wsd.wlink.nl "Ramon van der Winkel"%2:512/10.5
  3814.  
  3815. After translation:
  3816.  
  3817.      ramon@wsd.wlink.nl
  3818. ---------------------------------------------------------
  3819.  
  3820. Once again is the gateway AKA not important for the address
  3821. translation.
  3822.  
  3823. Notice that the mapping statements we have used so far are
  3824. working in both directions. What other options you have with
  3825. these mapping statements will be explained later.
  3826.  
  3827. Notice that if you only use a mapping statement for a user
  3828. with a user record and you don't fill in the UUCPname and
  3829. domain address fields, this user can only be addressed with
  3830. this e-mail address.
  3831.  
  3832. If you put a UUCPname and domain address in the user record,
  3833. all mail to whatever user at that domain will be sent to the
  3834. user's AKA (think about spelling problems). You might want to
  3835. use a combination.
  3836.  
  3837. Creating UUCP message headers in the netmail
  3838. --------------------------------------------
  3839.  
  3840. WaterGate allows you to put header lines in the netmail
  3841. message, which are then copied to the UUCP message. An example
  3842. could be "X-Info: Oh coolness!".
  3843.  
  3844. The headers have to be in the netmail messages as the first
  3845. lines. If you have a To: line in the message, then this must
  3846. be the first line of the message.
  3847. WaterGate manual                                        [page 73]
  3848.  
  3849. WaterGate only copies header lines up to an empty line or an
  3850. invalid header line. All other lines go in the body of the
  3851. UUCP message.
  3852.  
  3853. An valid UUCP header line start with a capital, has no spaces
  3854. in it, ends with a colon (":") and a space and is followed
  3855. with at least on line of text. The header line itself (before
  3856. the colon) has to be two characters at least.
  3857.  
  3858. Further, WaterGate does not allow the following system header
  3859. lines. These will be ignored.
  3860.  
  3861.      To:
  3862.      From:
  3863.      Path:
  3864.      Message-ID:
  3865.      Newsgroups:
  3866.      Subject:
  3867.      Date:
  3868.  
  3869. But it is very valid to use any other header line, for
  3870. example:
  3871.  
  3872.      Reply-To:
  3873.      Sender:
  3874.      Approved:
  3875.      References:
  3876.      etc.
  3877.      
  3878. It is advised that you put "X-" before the headerlines that
  3879. you make up yourself.
  3880.  
  3881. Apart from just copying all the header lines and removing them
  3882. from the body of the message, WaterGate now also deletes the
  3883. first empty line it finds at the start of the message, or just
  3884. behind the header lines. Usually, when you write a netmail to
  3885. a UUCP receipant, you keep an empty line between the TO: and
  3886. the "Hi!" line. This line used to show up in the mail message
  3887. as an extra empty line after the empty line that separates the
  3888. header lines and the body of the UUCP message. Not anymore.
  3889. Personally, I find that this hides even more the fact that the
  3890. message was created on a Fidonet system!
  3891. WaterGate manual                                        [page 74]
  3892.  
  3893. Using the gateway with mail
  3894. ---------------------------
  3895.  
  3896. If you are on UUCP and you want to send a message to somebody
  3897. on Fidonet, you have to send it to his address. There are two
  3898. general options for this. (In fact there are five options, as
  3899. mentioned in "Using the gateway with netmail").
  3900.  
  3901. In the first case, the user has a mapping statement on a
  3902. WaterGate system, which means that you can send the message to
  3903. a UUCP address and let WaterGate takes care of the
  3904. translation. Easy.
  3905.  
  3906. In the other case, where you know only the user■s full name
  3907. and a Fidonet address, for example "Ramon van der Winkel" at
  3908. 2:280/802.33, you have to use a special e-mail address that
  3909. WaterGate will detect, after which it translates the message.
  3910. This address looks like this:
  3911.  
  3912.      Ramon_van_der_Winkel@z2.n280.f802.p33.wlink.nl
  3913.  
  3914. The full name has been put in front of the of the @-sign and
  3915. the spaces in that name have been converted to underscores.
  3916. This underscore can be configured, so don't be surprised if
  3917. someone sends you a message from a WaterGate system with
  3918. different characters there.
  3919.  
  3920. The part after the @-sign is the destination address. The
  3921. Zone, Net, Node, and Point number have been coded in a special
  3922. form, as above. The last part of the address has to be one of
  3923. WaterGate's system domain addresses. This part is the address
  3924. of a system you know that runs WaterGate.
  3925.  
  3926. Some systems also allow "fidonet.org" as the last part of the
  3927. address. This only works if the UUCP provider and the
  3928. smarthost in the neighborhood of that system know that it
  3929. handles mail for that address. If this is not the case, the
  3930. message will be sent to a site somewhere in the world (such as
  3931. 1:1/31) that handles fidonet.org as well, after which it is
  3932. translated to a Fidonet message and then has to travel all the
  3933. way through Fidonet to get to its destination. That is not
  3934. what you want.
  3935.  
  3936. Please talk to your UUCP provider if you want to be a public
  3937. UUCP <-> Fidonet gateway for your neighborhood. You have to
  3938. add "fidonet.org" to your list of system domain addresses to
  3939. get this to work.
  3940.  
  3941. The best way to find out the e-mail address of a Fidonet user
  3942. is to let him send a message to you first, so you can see the
  3943. address.
  3944. WaterGate manual                                        [page 75]
  3945.  
  3946. The ROUTE.TDB file and its options
  3947. ----------------------------------
  3948.  
  3949. Although you can set a wide range of options in the
  3950. configuration program, there is also a wide gray area of
  3951. things it can't control. The ROUTE.TDB file is not only used
  3952. to configure your system■s routing, but has some additional
  3953. functions. You can use it to:
  3954.  
  3955.    - Make routing exceptions for certain systems.
  3956.    - Add signatures to Usenet news messages 
  3957.    - Map certain messages to other people.
  3958.    - Allow special addresses for yourself or other people.
  3959.    - Put restrictions on the use of the gateway
  3960.  
  3961. All this and more can be configured in the plain ASCII
  3962. textfile called ROUTE.TDB, that you can edit with MS-DOS's
  3963. "EDIT", for example.
  3964.  
  3965. In this ROUTE.TDB file, you can use the following commands:
  3966.  
  3967. ROUTE-FIDO     This command is used to route fido netmail
  3968.                messages through certain systems.
  3969.  
  3970. ROUTE-UUCP     This is nearly the same, but for routing UUCP
  3971.                mail messages through different UUCP up- and
  3972.                downlinks.
  3973.  
  3974. MAP-FIDO       When a netmail message is received for a
  3975.                certain user, you can map it to another user,
  3976.                possibly at another fido system.
  3977.  
  3978. MAP-UUCP       Besides mapping UUCP mail messages to other
  3979.                systems, this command is also used to assign
  3980.                different sender addresses to fido users.
  3981.  
  3982. FORBID-FIDO    You can forbid a certain fido user, a group of
  3983.                users, or everybody to use the gateway.
  3984.  
  3985. ALLOW-FIDO     After forbidding a group of people to use the
  3986.                gateway you can make an exception for one or
  3987.                more users or systems.
  3988.  
  3989. SIGNATURE      Most UUCP messages have a small signature part
  3990.                with some general (brag) information about the
  3991.                person writing the message or the service
  3992.                provider. Use this command to automatically add
  3993.                signature files to all messages created by a
  3994.                user or a system.
  3995.  
  3996. NEWSFILTER     Name of the file that contains the newsgroup
  3997.                names that you want to create automatically or
  3998.                not.
  3999.  
  4000. SENDFILE       You can use this statement to let WtrGate reply
  4001.                with the contents of a file, when somebody send
  4002.                a message to specific address. It is a simple
  4003.                file robot.
  4004. WaterGate manual                                        [page 76]
  4005.  
  4006. SAVEIf you want to store messages that were sent to
  4007.                a specific address to a directory, then use
  4008.                this statement. You can use it to make some
  4009.                automatic mechanism where a program processes
  4010.                the messages that were saved.
  4011.  
  4012. BOUNCE         If a system closes down or you don't want
  4013.                people to send mail somewhere, you can use this
  4014.                statement to block their path. The messages
  4015.                will be sent back with a specified reason.
  4016.  
  4017. GZIPBATCH      This can be used to set the first letter of the
  4018.                header that is added to news batches that
  4019.                compressed with GZip.
  4020.  
  4021. NOSLICE        When present, it disables the time slicing
  4022.                functionality.
  4023.  
  4024. The following pages contain an long explanation of each of the
  4025. statements.
  4026.  
  4027.  
  4028. ROUTE-FIDO: Route Fido messages
  4029. -------------------------------
  4030.  
  4031. WaterGate currently implements only a very simple form of Fido
  4032. routing:
  4033.  
  4034.      ROUTE-FIDO <System_We_Route_Through> [<addresses> [...]]
  4035.  
  4036.      ROUTE-FIDO 2:285/1       2:285/*
  4037.      ROUTE-FIDO 2:280/802     2:* 140:*
  4038.      ROUTE-FIDO 60:100/1      60:*
  4039.  
  4040. The destination system must be defined in the userbase.
  4041. WaterGate will report an error if the system is unknown.
  4042.  
  4043. When a netmail message is encountered, WaterGate will check
  4044. whether it is capable of transporting a message to its
  4045. destination address. In the above example, a message for
  4046. 2:255/1000 would be sent via 2:280/802, as would a message for
  4047. 140:1000/100. However a message for 2:285/500 would be routed
  4048. via 2:285/1
  4049.  
  4050. If WaterGate is incapable of routing a message, to 133:100/1
  4051. for exaple, an attempt is made to bounce the message to its
  4052. sender.
  4053.  
  4054. If more than one routing statement can be used for a certain
  4055. address, the routing statement with the highest address match
  4056. will be used. For example 2:285/1000 will be routed to 2:285/1
  4057. (two matches) and not via 2:280/802 (one match only).
  4058.  
  4059. If the system is in FrontDoor compatible mode, the routing
  4060. statements are not used. Instead, everything is put in the
  4061. netmail directory, where FrontDoor/InterMail will take care of
  4062. the routing.
  4063. WaterGate manual                                        [page 77]
  4064.  
  4065. ROUTE-UUCP: Route UUCP messages
  4066. -------------------------------
  4067.  
  4068. The routing of UUCP mail can be implemented in two different
  4069. ways. One is by configuring routings using the WTRCONF.EXE
  4070. program; the other is by using statements in the ROUTE.TDB
  4071. file.
  4072.  
  4073. Usually, this is a proper way of setting up the system:
  4074.  
  4075. First, define your UUCP neighbors in the userbase. This is
  4076. mandatory; if your neighbors are not defined here, you cannot
  4077. route messages to or through them.
  4078.  
  4079. In these user records, you can also define their domain
  4080. address and aliases, if any. There is a limit of 6 domain
  4081. addresses for each neighbor.
  4082.  
  4083. Note that logically it does not matter if your neighbor is
  4084. physically a Fidonet style node. This only affects the format
  4085. of output created for your nodes, but is not of any importance
  4086. for the names and routing of mail.
  4087.  
  4088. Next, define the systems that are more than one 'hop' away,
  4089. i.e., not your neighbors, in your ROUTE.TDB file. The format
  4090. of a UUCP-routing line in the ROUTE.TDB is:
  4091.  
  4092.      ROUTE-UUCP <UUCP-name> <System-address>
  4093.  
  4094. where <UUCP-name> must be the UUCPname of one of your
  4095. neighbors as defined in your userbase.
  4096.  
  4097. <System-address> can be:
  4098.  
  4099.      - The UUCPname of a system more than one hop away
  4100.      - The complete domain address of a system
  4101.      - A domain address with wildcards
  4102.  
  4103. If nodes under you have a world-registered UUCPname, you can
  4104. use this UUCPname in bangpath addressing. If the name of the
  4105. system through wich a message should be routed is missing from
  4106. the bangpath, a UUCPname routing statement can enable the mail
  4107. to arrive anyway.
  4108.  
  4109. By using a complete domain address, you specifically route
  4110. mail for that domain to one of your neighbors. The domain
  4111. address must match 100% for it to work. This is the most
  4112. widely used form of UUCP routing.
  4113.  
  4114. Note that this method can be used to add more domain names to
  4115. one of your neighbors that is defined in the userbase, where
  4116. you have space for only six domain addresses. On the other
  4117. hand, you can also use those six lines as ROUTE-UUCP
  4118. statements. Although it does work, we don't recommend using
  4119. it, as you loose the complete view and control rather quickly.
  4120. WaterGate manual                                        [page 78]
  4121.  
  4122. Wildcards in the <System-address> allow you to route a
  4123. complete hierarchy of domain-addresses to a certain neighbor
  4124. without having to define each sub-node of that system
  4125. separately. This allows your nodes to have sub-nodes of their
  4126. own and they can create as many as they want. This is very
  4127. useful when you or one of your nodes uses fido-style addresses
  4128. like "user@z2.n280.f802.p10.hisnode.wlink.nl".
  4129.  
  4130. You can then 'wildcard' the fido segment of the complete
  4131. domain address, so you won't have to define each fido-style
  4132. address he wants to use.
  4133.  
  4134. There are currently two types of wildcards:
  4135.  
  4136.      1) .yournode.wlink.nl
  4137.      2) *.yournode.wlink.nl
  4138.  
  4139. There is a very slight difference: Type 1 will route ALL
  4140. addresses that end in 'yournode.wlink.nl', including
  4141. subdomains and the address "@yournode.wlink.nl" itself. Type 2
  4142. will ONLY route subdomains, and will NOT route addresses like
  4143. "user@yournode.wlink.nl".
  4144.  
  4145. Here are some example ROUTE-UUCP statements:
  4146.  
  4147.      ROUTE-UUCP picard enterprize.space.nasa.gov
  4148.  
  4149. This ROUTE-UUCP line will route all mail for domain
  4150. "enterprize.space.nasa.gov" to the system with the UUCPname
  4151. "picard". This system must be defined in your userbase.
  4152.  
  4153. E.g., addresses like "Mr.Spock@enterprize.space.nasa.gov" or
  4154. "enterprize.space.nasa.gov!Mr.Spock" will be sent to the
  4155. system named "picard". Subdomains are not allowed here and the
  4156. domain-address will have to match 100%.
  4157.  
  4158.      ROUTE-UUCP nixon *.WaterGate.wlink.nl
  4159.  
  4160. This line will route all mail destined for all subdomains (and
  4161. subdomains only!) of "WaterGate.wlink.nl" to the system with
  4162. UUCPname "nixon". Once again, "nixon" must be defined in the
  4163. userbase.
  4164.  
  4165. For example:
  4166.  
  4167.      "operator@phonetaps.WaterGate.wlink.nl"
  4168. or
  4169.      "oval.office.WaterGate.wlink.nl!president"
  4170.  
  4171. will be routed to that system. It will NOT route addresses
  4172. like "first.lady@WaterGate.wlink.nl" or
  4173. "WaterGate.wlink.nl!authors".
  4174.  
  4175.      ROUTE-UUCP rspca .rodent.net
  4176.  
  4177. This line will route all mail to users with domain addresses
  4178. ending in "rodent.net" to the system with the UUCPname
  4179. "rspca". For example, "mickey.mouse@rodent.net" as well as
  4180. WaterGate manual                                        [page 79]
  4181.  
  4182. "rabbits.rodent.net!bugs.bunny" or "sylvester@cats.rodent.net"
  4183. are routed to the "rspca" system, which has to be defined in
  4184. your userbase.
  4185.  
  4186.      ROUTE-UUCP picard xs4all
  4187.  
  4188. This last example routes all mail sent to "annie.user@xs4all"
  4189. or "xs4all!xs4no1!mary.helen" to the system with UUCPname
  4190. "picard". Because "xs4all" does not appear to be a domain
  4191. style address, it makes us suspect this routing line is used
  4192. to alias another UUCPname or to be able to route a UUCPname of
  4193. a system that is not our neighbor.
  4194.  
  4195. About bangpaths
  4196. ---------------
  4197.  
  4198. Any system that is defined on UUCP has a bangpath, but not all
  4199. systems have domain addresses. Therefore, bangpath addressing
  4200. is always possible. Bangpaths are usually built up from
  4201. UUCPnames (to keep them short), but a bangpath can also
  4202. contain a domain addresses.
  4203.  
  4204. Internally, WaterGate converts all addresses to bangpaths.
  4205. Then, for routing, it only looks at the part of the address
  4206. that is in front of the first bang (bang = !). If that part of
  4207. the address turns out to be its own UUCPname, and the address
  4208. contains more than one bang, it looks at the part between the
  4209. first and the second bang. This algorithm allows a very
  4210. powerful and flexible way of UUCP mail routing and, knowing
  4211. this, you may find some ingenious and creative ways to perform
  4212. all the routing you want.
  4213.  
  4214. Don't use bangpaths in MAP-UUCP statements where you use a
  4215. username as well, because there is no way for WaterGate to
  4216. find out if the last part of the bang-path is a username or
  4217. the name of a system. Use domain addresses instead.
  4218.  
  4219. Routing things you cannot do in ROUTE.TDB
  4220. -----------------------------------------
  4221.  
  4222. You cannot put more than one <System-address> on a ROUTE-UUCP
  4223. line. If you do this anyway, the line will be ignored. If you
  4224. want more routings to the same UUCPname, then simply use as
  4225. many lines as you need to route all system addresses and have
  4226. them start with the same UUCPname.
  4227.  
  4228. You cannot chain the routing of UUCP-names. E.g.:
  4229.  
  4230.      ROUTE-UUCP picard nixon
  4231.      ROUTE-UUCP nixon  *.watergate.wlink.nl
  4232.  
  4233. This will NOT cause mail for *.WaterGate.wlink.nl to be routed
  4234. to system "picard". WaterGate will try to route it directly to
  4235. "nixon", even though "nixon" is routed to "picard". Instead,
  4236. use something like this:
  4237.  
  4238.      ROUTE-UUCP picard nixon
  4239.      ROUTE-UUCP picard *.watergate.wlink.nl
  4240. WaterGate manual                                        [page 80]
  4241.  
  4242. The reason is obvious: to prevent routing loops. 
  4243.  
  4244. You cannot 'wildcard' bits and pieces of domain addresses.
  4245. E.g.:
  4246.  
  4247.      ROUTE-UUCP picard *gate.wlink.nl
  4248.  
  4249. This will NOT cause mail for "WaterGate.wlink.nl" or
  4250. "water.gate.wlink.nl" to be routed to "picard". In fact, this
  4251. may cause funny routing behavior.
  4252.  
  4253. A few last remarks about UUCP routing
  4254. -------------------------------------
  4255.  
  4256. If mail addresses contain capitalization, it will be kept
  4257. intact, but will be ignored for routing. Capitalization in
  4258. your routing statements (make them wolverine if you wish) will
  4259. also be ignored. In other words: the routing in WaterGate is
  4260. case-insensitive.
  4261.  
  4262. All routing techniques discussed here about the ROUTE.TDB file
  4263. also apply to the domain addresses defined in the userbase.
  4264. Whatever you fill in there will have the same effect as
  4265. defining just as many ROUTE-UUCP lines that all start with the
  4266. <UUCP-name> of that user. However, it is wise to stick to the
  4267. structure as proposed above.
  4268.  
  4269. If the format of your ROUTE-UUCP statements are incorrect,
  4270. then this may (and often will) cause unpredictable routing
  4271. behavior. So make sure that all your routing statements are
  4272. correct. Keeping the definition structure as proposed above
  4273. will help to keep things clear and obvious, so you can almost
  4274. immediately locate the problem if any problem occurs.
  4275. WaterGate manual                                        [page 81]
  4276.  
  4277. MAP-FIDO: Mapping fido netmail messages
  4278. ---------------------------------------
  4279.  
  4280. The MAP-FIDO command is used to map received fido netmail
  4281. messages to a different destination. For example, you can use
  4282. this option to map messages for users that also have a point
  4283. address to their point, or you can map messages for a fido
  4284. user to a different system, or even a UUCP system. Note: It
  4285. only works on the To: address of netmail messages.
  4286.  
  4287. There are two forms of this command:
  4288.  
  4289.      MAP-FIDO "username"%fidoaddr "username"%fidoaddr
  4290. and
  4291.      MAP-FIDO "username"%fidoaddr user@domain
  4292.  
  4293. Examples and an explanation of all the options follow:
  4294.  
  4295. 1.   MAP-FIDO "username"      "username"
  4296.      MAP-FIDO "jaap aap"      "SysOp"
  4297.  
  4298. Map netmail messages for a user on your system to a different
  4299. user on your own system. All your system AKAs are accepted.
  4300.  
  4301. 2.   MAP-FIDO "username"           "username"%2:280/803
  4302.      MAP-FIDO "username"%2:280/802 "username"
  4303.      MAP-FIDO "username"%2:280/802 "username"%2:280/803
  4304.  
  4305. This is the same as for the first example, except that in the
  4306. first line the message is now mapped to 2:280/803 instead of
  4307. to your own system. The second line shows how a message
  4308. passing through your system can be mapped to a local user, and
  4309. the third shows how that message can also be re-addressed to
  4310. another system.
  4311.  
  4312. 3.   MAP-FIDO "username"           user@domain
  4313.      MAP-FIDO "username"%2:280/802 user@domain
  4314.      MAP-FIDO "jaap aap"           jaap.aap@network.nl
  4315.  
  4316. Received netmail can also be mapped to an Internet domain
  4317. address; this is a one way conversion. Messages for
  4318. jaap.aap@network.nl are not mapped back to the "jaap aap" fido
  4319. user! Neither can you specify a domain address for the first
  4320. parameter!
  4321.  
  4322. Order of precedence for MAP-FIDO
  4323. --------------------------------
  4324.  
  4325. When more than one MAP-FIDO statement could be applied to a
  4326. netmail message, the mapping statement that will be used is
  4327. selected as follows:
  4328.  
  4329. When only the address matches, the last mapping statement will
  4330. be used. If a mapping statement exists that both matches the
  4331. address and the user name, then that mapping is used and the
  4332. search is stopped.
  4333. WaterGate manual                                        [page 82]
  4334.  
  4335. MAP-UUCP: Mapping UUCP mail messages
  4336. ------------------------------------
  4337.  
  4338. Mapping received UUCP mail messages is a little more
  4339. complicated, as there are quite a lot of possible options. It
  4340. is possible to map a message for a user to another user, or
  4341. map all messages for a system to another system, or even to
  4342. one user. Besides that, you can use the information BACKWARDS
  4343. to allow mapping of fido addresses into domain addresses.
  4344.  
  4345. If you want these commands only to work from Fidonet to UUCP,
  4346. you can use the prefix -FU. If you only want them to work from
  4347. UUCP to Fidonet, you can use the prefix -UF. If you want them
  4348. to work in both directions, then don't use a prefix at all.
  4349. The prefix has to be put on the line right after the command.
  4350.  
  4351. The two basic formats of this command are:
  4352.  
  4353.      MAP-UUCP user@domain user@domain
  4354.      MAP-UUCP user@domain "username"%fidoaddr
  4355.  
  4356. Examples and an explanation of each of the options follow
  4357. below:
  4358.  
  4359. 1.   MAP-UUCP user@domain user@domain
  4360.  
  4361.      MAP-UUCP jaap.aap@network.nl  sysop@network.nl
  4362.      MAP-UUCP jaap.aap@network.nl  aapwork.nl
  4363.      MAP-UUCP jaap.aap@network.nl  jaap.aap@aapwork.nl
  4364.  
  4365. The simplest map is to send all message from one user to
  4366. another. Use this, for example, if you use multiple usernames,
  4367. but like to have all replies to 'SysOp'.
  4368.  
  4369. The last two options are equivalent, and will both deliver all
  4370. messages for jaap.aap@network.nl to jaap.aap@aapwork.nl
  4371.  
  4372.  
  4373. 2.   MAP-UUCP domain user@domain
  4374.  
  4375.      MAP-UUCP oldserver.network.nl sysop@newserver.network.nl
  4376.  
  4377. Use this combination to send all messages for a complete
  4378. domain to a single user at another system. This may come in
  4379. handy when one of your downlinks changes its name or is
  4380. temporarily offline.
  4381.  
  4382.  
  4383. 3.   MAP-UUCP domain domain
  4384.  
  4385.      MAP-UUCP oldserver.network.nl newserver.network.nl
  4386.  
  4387. This will map all messages for all users of a domain to the
  4388. same users at another domain address.
  4389. WaterGate manual                                        [page 83]
  4390.  
  4391. 4.MAP-UUCP user@domain "username"
  4392.      MAP-UUCP user@domain "username"%fidoaddr
  4393.      MAP-UUCP user@domain fidoaddr
  4394.  
  4395.      MAP-UUCP jaap@aapwork.nl "jaap aap"
  4396.      MAP-UUCP jaap@aapwork.nl "jaap aap"%2:280/802
  4397.      MAP-UUCP jaap@aapwork.nl 2:280/802
  4398.  
  4399. To map all messages for "user@domain" to a fido system, simply
  4400. specify the username at your own system, or the name of a user
  4401. at another fido system.
  4402.  
  4403.  
  4404. 5.   MAP-UUCP domain fidoaddr
  4405.      MAP-UUCP domain "username"%fidoaddr
  4406.  
  4407.      MAP-UUCP aapwork.nl 2:280/802
  4408.      MAP-UUCP aapwork.nl "sysop"%2:280/802
  4409.  
  4410. This combination will send all messages for an entire domain
  4411. to a fido system. The user names will be correctly translated
  4412. into an acceptable fido form. (Jaap_Aap -> Jaap Aap)
  4413.  
  4414. Order of precedence for MAP-UUCP
  4415. --------------------------------
  4416.  
  4417. When more than one mapping statement can be applied to a
  4418. particular message, then only the first mapping statement is
  4419. used.
  4420.  
  4421. FORBID-FIDO/ALLOW-FIDO: Restricting the gateway
  4422. -----------------------------------------------
  4423.  
  4424. Acting as a public gateway may be a really rewarding thing for
  4425. your soul, and a great thing for mankind; but it's not going
  4426. to pay your monthly phone bills. By default, WaterGate will
  4427. allow everyone to gate messages between a fido and a UUCP
  4428. network.
  4429.  
  4430. Add the following command to your ROUTE.TDB file:
  4431.  
  4432. FORBID-FIDO *
  4433.  
  4434. Now nobody, including yourself, is allowed to use the gateway;
  4435. probably not exactly what you intended. Now relax this a
  4436. little by giving some people access rights:
  4437.  
  4438. ALLOW-FIDO     2:280/*
  4439. ALLOW-FIDO     2:281/*
  4440. ALLOW-FIDO     2:280/802   Maarten User
  4441. ALLOW-FIDO     2:280/802   SysOp
  4442. ALLOW-FIDO     2:280/18.*
  4443. FORBID-FIDO    2:280/18    Jaap User
  4444.  
  4445. This allows everyone within the nets 280 & 281--except a
  4446. special case, "Jaap User" at 2:280/18--to use the gateway.
  4447. Plus 2:280/18 and its points, and "Maarten User" and "SysOp"
  4448. at the system 2:280/802, are allowed to use the gateway.
  4449. WaterGate manual                                        [page 84]
  4450.  
  4451. MAP-AREA: Receive a mailing list in a message base
  4452. --------------------------------------------------
  4453.  
  4454. Quite some users on a BBS will subscribe to a mailing list and
  4455. receive this as netmail on the BBS. There is quite some flow
  4456. in some of these mailing lists, so that means a lot of
  4457. messages in your netmail area.
  4458.  
  4459. Also, if more users on your BBS want to receive the same
  4460. mailing list, you will receive more than one copy of these
  4461. messages and they will all have to be stored in the netmail
  4462. area until the users have read and deleted them.
  4463.  
  4464. It is not possible to set up a local mailing list and feed all
  4465. incoming messages into that list, because the sender of the
  4466. message must be connected to the local mailing list. And in
  4467. most cases, the sending will be the original sender of the
  4468. message that was distributed by the mailing list server. It is
  4469. impossible to have all these names in your local mailing list
  4470. setup.
  4471.  
  4472. If you don't like all these messages in your netmail area, or
  4473. want to provide a mailing list for all your users, so you only
  4474. have one copy of them, you have to take a look at the MAP-AREA
  4475. statement.
  4476.  
  4477. Basically, what the MAP-AREA statement does is convert
  4478. incoming e-mail into news. The news is then distributed, gated
  4479. to echomail and stored in your message base.
  4480.  
  4481. When you receive e-mail from a mailing list, you always
  4482. receive that to the same name. Because the MAP-AREA statements
  4483. takes all incoming mail to a certain address, you have to
  4484. subscribe to the mailing list with a special "receiver"
  4485. address, or else all your e-mail will be mapped.
  4486.  
  4487. For example, you are connected to the mailing list WaterGate,
  4488. which is watergate@wsd.wline.se. You receive the mailing list
  4489. messages as wg-receiver@bravo.com and you want this to be put
  4490. in the area you created with the name WG-LIST. You then use
  4491. the following statement in your ROUTE.TDB file:
  4492.  
  4493. MAP-AREA wg-receiver@bravo.com WG-LIST
  4494.  
  4495. Where WG-LIST can be either the Fido or UUCP name of the area.
  4496.  
  4497. Notice that this statement looks at the e-mail address that
  4498. can be found in the .X file in your spool directory. Only MAP-
  4499. UUCP statments are processed before the MAP-AREA is checked
  4500. against that address.
  4501. WaterGate manual                                        [page 85]
  4502.  
  4503. SIGNATURE: Adding signatures to a message
  4504. -----------------------------------------
  4505.  
  4506. Most messages found on UUCP have some kind of signature at the
  4507. end, usually containing some information about the writer, the
  4508. fact that whatever he or she wrote wasn't done with all senses
  4509. intact, and that his employer would be most surprised if
  4510. someone took it seriously. Of course, this can be done in a
  4511. million unique ways, and as long as the message isn't
  4512. irritating (try to keep it at four lines or less), nobody will
  4513. bother.
  4514.  
  4515. Since most Fido style BBS programs are unable to add
  4516. signatures to a message by default, or aren't capable of using
  4517. different ones for different users, you can have WaterGate do
  4518. it automatically. All you need for each signature is a small
  4519. text file containing the signature, and a definition in the
  4520. ROUTE.TDB.
  4521.  
  4522.      SIGNATURE filepath fidoaddr {username}
  4523.  
  4524. SIGNATURE D:\BBS\SIG\DEFAULT.SIG   2:280/802
  4525. SIGNATURE D:\BBS\SIG\SYSOP.SIG     2:280/802 Jaap Aap
  4526. SIGNATURE D:\BBS\SIG\NEOLINK.SIG   2:280/801
  4527.  
  4528. This will add DEFAULT.SIG to all messages gated from Fido to
  4529. UUCP originating from 2:280/802, except that user "Jaap Aap"
  4530. will get the SYSOP.SIG signature instead.
  4531.  
  4532. An example signature file:
  4533.  
  4534. ,----------------------------.------------------------------.
  4535. | Martijn Dijksterhuis       | Kids! Bringing about         |
  4536. | martijnd@dijkline.wlink.nl | Armageddon can be dangerous. |
  4537. | martijnd@htsa.aha.nl       | Do not attempt it at home    |
  4538. `----------------------------.------------------------------'
  4539.  
  4540. For automatic processing, the signature will be preceded by a
  4541. tear-line, just as in fido messages. This tearline consists of
  4542. two dashes followed by a space. WaterGate automatically adds
  4543. this tearline, so there is no need to put it in the signature
  4544. file.
  4545.  
  4546. On the next page is an excerpt about signatures from a classic
  4547. article (the article is regularly posted to
  4548. news.announce.newusers by Gene Spafford):
  4549. WaterGate manual                                        [page 86]
  4550.  
  4551. Q: Dear Miss Postnews: How long should my signature be? --
  4552. verbose@noisy
  4553.  
  4554. A: Dear Verbose: Please try and make your signature as long as
  4555. you can. It's much more important than your article, of
  4556. course, so try to have more lines of signature than actual
  4557. text.
  4558.  
  4559. Try to include a large graphic made of ASCII characters, plus
  4560. lots of cute quotes and slogans. People will never tire of
  4561. reading these pearls of wisdom again and again, and you will
  4562. soon become personally associated with the joy each reader
  4563. feels at seeing yet another delightful repeat of your
  4564. signature.
  4565.  
  4566. Be sure as well to include a complete map of UUCP with each
  4567. signature, to show how anybody can get mail to you from any
  4568. site in the world. Be sure to include Internet gateways as
  4569. well. Also tell people on your own site how to mail to you. 
  4570. Give independent addresses for Internet, UUCP, and BITNET,
  4571. even if they're all the same.
  4572.  
  4573. Aside from your reply address, include your full name, company
  4574. and organization. It's just common courtesy -- after all, in
  4575. some newsreaders people have to type an *entire* keystroke to
  4576. go back to the top of your article to see this information in
  4577. the header.
  4578.  
  4579. By all means include your phone number and street address in
  4580. every single article.  People are always responding to UUCP
  4581. articles with phone calls and letters.  It would be silly to
  4582. go to the extra trouble of including this information only in
  4583. articles that need a response by conventional channels!
  4584. WaterGate manual                                        [page 87]
  4585.  
  4586. NEWSFILTER: Auto-created newsgroups filter
  4587. ------------------------------------------
  4588.  
  4589. The NEWSFILTER statement points to a file that WaterGate uses
  4590. to decide whether an area should be created automatically when
  4591. a unknown newsgroup name is detected.
  4592.  
  4593. If you have "New area create" enabled in the user record of
  4594. your UUCP uplink, then you might have noticed that WaterGate
  4595. creates a lot of new areas with funny names. Most of these
  4596. areas you don't want to have at all.
  4597.  
  4598. The new newsgroups filter file allows you to tell WaterGate
  4599. which newsgroups you want to have auto-created and which you
  4600. do not. By default, WaterGate doesn't auto-create a newsgroup
  4601. at all, until you install the NEWSFILTER file.
  4602.  
  4603. In this file, you can enter the complete or partial names of
  4604. the newsgroups. There are special characters and wildcards
  4605. that save you a lot of typing. People that are familiar with
  4606. the Waffle FEEDS file will find some resemblances.
  4607.  
  4608. ALT.*
  4609. COMP.*
  4610. !COMP.OS.*
  4611.  
  4612. This file tells WaterGate that you don't want any newsgroups
  4613. unless they start with ALT and COMP. But, you don't want the
  4614. newsgroups that start with COMP.OS.
  4615.  
  4616. The exclamation sign (!) is a "NOT" operator.
  4617.  
  4618. The extension dot plus asterisk (.*) means that you want all
  4619. the newsgroups that start with that text, but not the
  4620. newsgroup that starts with that name itself (for example
  4621. "ALT").
  4622.  
  4623. Here is a somewhat more complicated example:
  4624.  
  4625. ALT.*
  4626. !ALT.BBS.*
  4627. ALT.BBS.WATERGATE
  4628. !ALT.BBS.WATERGATE.D.
  4629.  
  4630. This file basically tells WaterGate that you want all the
  4631. newsgroups that start with ALT, but not the newsgroups that
  4632. start with ALT.BBS, except newsgroups that start with
  4633. ALT.BBS.WATERGATE, which you do want, but not that one special
  4634. ALT.BBS.WATERGATE.D newsgroup.
  4635.  
  4636. The extension dot (.) means that you want the newsgroup with
  4637. that name and only that newsgroup, not the newsgroup with
  4638. names that start with this. If the exclamation sign (!) is in
  4639. front, it means that you don't want that specific newsgroup.
  4640.  
  4641. You can also put comments in the filter file on any line you
  4642. want by putting in a semi-colon (;) before the comment.
  4643. WaterGate manual                                        [page 88]
  4644.  
  4645. A special case is when the NEWSFILTER statement is not present
  4646. in the ROUTE.TDB file, or the news filter file could not be
  4647. opened, or it is empty, or the ROUTE.TDB file is not present.
  4648. In that case, no new newsgroup names filter statements are
  4649. present. WaterGate then allows all new newsgroup names. That
  4650. way, you don't have to setup the filter file at once. This is
  4651. reported in the logfile at startup of WtrGate with the line
  4652. "Allowing all new newsgroup names".
  4653.  
  4654. Logging information
  4655. -------------------
  4656.  
  4657. When your filter file gets big, it might become troublesome to
  4658. find why a certain newsgroup name is rejected by WaterGate,
  4659. while you want it, or why a certain newsgroup name is allowed,
  4660. while you don't want it.
  4661.  
  4662. If you enable the "New newsgroup names check" logfile option,
  4663. WaterGate will tell you when it accepted or rejected a certain
  4664. newsgroup and which line in the logfile caused the decision.
  4665.  
  4666. For example,
  4667.  
  4668. ALT.*
  4669. !ALT.BBS.*
  4670. ALT.BBS.WATERGATE
  4671. !ALT.BBS.WATERGATE.D.
  4672.  
  4673. The newsgroup ALT.BBS.WATERGATE is accepted, because of line
  4674. three. If line three was not there, then line two would have
  4675. caused WaterGate to reject it. When WaterGate processes the
  4676. filter file, it looks at every single line; if that line
  4677. applies to the newsgroup name, the decision to accept or
  4678. reject the newsgroup can be changed.
  4679.  
  4680.  
  4681. SENDFILE: a simple file robot
  4682. -----------------------------
  4683.  
  4684. You can let WaterGate reply to a message automatically. You
  4685. prepare the reply in a file that is put in the body of the
  4686. reply message. If you want to send a file, you have to UU-
  4687. encode it yourself first.
  4688.  
  4689. The sendfile statement works from both the UUCP side as the
  4690. Fido side.
  4691.  
  4692. The format of this statement is:
  4693.  
  4694. SENDFILE <user name> <path to file>
  4695.  
  4696. For example:
  4697.  
  4698. SENDFILE watergate-info c:\wsd\wginfo.txt
  4699. SENDFILE wtrkit-req c:\wsd\wtrkit.txt
  4700. WaterGate manual                                        [page 89]
  4701.  
  4702. The e-mail address where people have to send their message to
  4703. is the <user name> at any of your system domain addresses, for
  4704. example watergate-info@wsd.wline.se.
  4705.  
  4706. For fidonet, people have to send a netmail message to <user
  4707. name> at one of your system AKAs, for example watergate-info
  4708. at 2:200/111.
  4709.  
  4710.  
  4711. BOUNCE: Send mail back with a reason
  4712. ------------------------------------
  4713.  
  4714. You can use the bounce option for more than one purpose, but
  4715. it is mostly used to inform people that certain e-mail
  4716. addresses or even a whole system cannot be used anymore.
  4717.  
  4718. The e-mail address you have to put in the statement has to
  4719. match only partitially. Or in other words: the search string
  4720. you put in the statement must appear in the e-mail address
  4721. that is checked.
  4722.  
  4723. Not only is the message returned to the sender, but you can
  4724. supply a reason as well. To support multiple languages, you
  4725. have to put "Reason: " in front as well, if you which.
  4726.  
  4727. The format for this statement is:
  4728.  
  4729. BOUNCE <partitial e-mail address> "Reason"
  4730.  
  4731. For example:
  4732.  
  4733. BOUNCE wsd.wlink.nl "Reason: moved to Sweden"
  4734. BOUNCE ftpmail "Reason: ftpmail option is blocked!"
  4735. BOUNCE erik@wsd.wlink.nl "Reason: Account is closed!"
  4736.  
  4737.  
  4738. SAVE: Write messages to disk
  4739. ----------------------------
  4740.  
  4741. With the SAVE statement you can save messages that were
  4742. received at a specific e-mail address to a file on disk. The
  4743. contents of the messages are completely saved in the file.
  4744.  
  4745. You can use it to let an external program process the message
  4746. and send a reply, although there are no posting options in
  4747. WaterGate yet.
  4748.  
  4749. The e-mail address that is check has to match exactly. So, it
  4750. is not possible to save all messages for a complete domain in
  4751. a directory. This is to protect systems.
  4752.  
  4753. After the message has been saved, it is destroyed and not sent
  4754. along.
  4755.  
  4756. The format of the SAVE statement is:
  4757.  
  4758. SAVE <e-mail address> <directory>
  4759. WaterGate manual                                        [page 90]
  4760.  
  4761. For example:
  4762.  
  4763. SAVE ftpmail_receiver@wsd.wlink.nl c:\saved\
  4764.  
  4765.  
  4766. MAP-UUCP and BOUNCE, SAVE, SENDFILE
  4767. -----------------------------------
  4768.  
  4769. The MAP-UUCP statement is processed before the BOUNCE, SAVE
  4770. and SENDFILE options are checked. This way, you can "route"
  4771. messages that are sent to different addresses all to one
  4772. address and then use one bounce, save or sendfile statement.
  4773.  
  4774. Of course, it is perfectly possible to use more that one
  4775. bounce, save or sendfile statement that have the save reason,
  4776. use the same directory or point to the same file.
  4777.  
  4778.  
  4779. GZIPBATCH
  4780. ---------
  4781.  
  4782. This option can be used to set the first letter of the header
  4783. that can be added to news batches that have been compressed
  4784. with GZip. The header is used on UNIX systems to find out that
  4785. the batch is compressed. Actually, it is a command that
  4786. executes a script.
  4787.  
  4788. This script is called "cunbatch" when the batch is compressed
  4789. with normal compress. The names of the script for gzip
  4790. compressed batches is differing though. Normally, it is
  4791. gunbatch, but it can also be zunbatch.
  4792.  
  4793. To overcome this difference, you can set this letter system-
  4794. wide (for all your UUCP users that you compress with gzip for
  4795. and have the "Add batch header" option set to YES).
  4796.  
  4797. The format of this line is:
  4798.  
  4799. GZIPBATCH <letter>
  4800.  
  4801. for example:
  4802.  
  4803. GZIPBATCH z
  4804.  
  4805. You normally don't need this statement.
  4806.  
  4807.  
  4808. NOSLICE
  4809. -------
  4810.  
  4811. You can use this statement to disable the new time slicing
  4812. functionality. In case it crashes on your system, use this
  4813. option to disable it.
  4814.  
  4815. It also speeds up WaterGate a little bit, but slows down all
  4816. the other programs that are runnning in the same multi tasker
  4817. environment.
  4818. WaterGate manual                                        [page 91]
  4819.  
  4820. Using AreaFix / newsfix
  4821. -----------------------
  4822.  
  4823. WaterGate has a built-in Area Manager to allow your users to
  4824. easily maintain the areas in which they receive messages.
  4825.  
  4826. A Fido user has to send a netmail message to "AreaFix" at one
  4827. of your system AKAs. A UUCP user has to send a mail message to
  4828. "newsfix" at one of your system domain addresses. For both,
  4829. the password has to be in the subject line.
  4830.  
  4831. Examples:
  4832.  
  4833. [Fido Netmail]
  4834. From: Jaap Aap           2:280/802.67
  4835. To  : AreaFix            2:280/802
  4836. Subj: MyPassword
  4837. --------------------------------------------
  4838.  
  4839. +ARENA
  4840. -POINTS.028
  4841. %QUERY
  4842.  
  4843. [UUCP mail]
  4844. From: Jaap@TheNode.Network.Nl
  4845. To  : NewsFix@HostNode.NetWork.Nl
  4846. Subj: MyPassword
  4847. --------------------------------------------
  4848.  
  4849. +ARENA
  4850. -POINTS.028
  4851. %QUERY
  4852.  
  4853.  
  4854. The following commands are available:
  4855.  
  4856. AREANAME       This will connect the area with the name
  4857.                "AREANAME" for the requesting user, if the area
  4858.                exists and the user has access to that area (it
  4859.                has to be in a group to which the user has
  4860.                access). Optionally, you can use +AREANAME.
  4861.  
  4862. -AREANAME      This will disconnect the user from the area
  4863.                with the name "AREANAME". A user can always
  4864.                disconnect an area, even if he no longer has
  4865.                access to connect it.
  4866.  
  4867. %+ALL          This will connect the user to all the areas to
  4868.                which he has access.
  4869.  
  4870. %-ALL          This will disconnect the user from all the
  4871.                areas to which he is connected.
  4872. WaterGate manual                                        [page 92]
  4873.  
  4874. %PASSIVEThis will stop WaterGate from sending messages
  4875.                to this user. This is especially useful when
  4876.                the user goes on a holiday, for example, and
  4877.                doesn't want to have messages pile up. This
  4878.                will not affect netmail or mail messages.
  4879.  
  4880. %ACTIVE        If a node is ready to receive messages again,
  4881.                he can issue this command, after which
  4882.                WaterGate will resume preparing mail for this
  4883.                user.
  4884.  
  4885. %FROM <addr>   If a user is allowed to do remote maintenance
  4886.                (see User Configuration), then all
  4887.                modifications following the %FROM line, will be
  4888.                made to the user specified in <addr>. Multiple
  4889.                %FROM lines may be used in messages. If
  4890.                anything goes wrong (e.g., a user with <addr>
  4891.                does not exist), all further commands are
  4892.                ignored until the end of the message or another
  4893.                %FROM line.
  4894.                Note: this option is currently (version 0.18)
  4895.                disabled.
  4896.  
  4897. %HELP          The user can issue this command to request
  4898.                help. WaterGate will send a short list of all
  4899.                the commands that the user can use. If the user
  4900.                is allowed to use a special AreaFix command, it
  4901.                will also be shown.
  4902.  
  4903. %LIST          This will send a list of all the areas to which
  4904.                the user is currently connected. The areas will
  4905.                be grouped and sorted, and the list will also
  4906.                indicate whether a group is read-only.
  4907.  
  4908. %QUERY         WaterGate will create a list of all areas
  4909.                available to the node and send it. The areas
  4910.                will be grouped and sorted, with the
  4911.                descriptions of the areas from the Comment
  4912.                field in the area record.
  4913.  
  4914. See the chapter "Installing the .TXT files" for information
  4915. about the .TXT files you can use to override the standard help
  4916. message and the headers and footers of the lists.
  4917.  
  4918. You can also use the old style query and list requests:
  4919. putting -Q or -L after your password, with a space in between.
  4920. WaterGate manual                                        [page 93]
  4921.  
  4922. Installing the DPMI version
  4923. ---------------------------
  4924.  
  4925. This chapter explains you what the DPMI version (WTRGATED.EXE)
  4926. is for, what you need to run it, and how to install it. It
  4927. also contains a discussion about whether to use the swapfile
  4928. or DPMI memory, because the recent introduction of swap memory
  4929. might mean the discontinuation of the DPMI version in future
  4930. releases. Let us know what you think.
  4931.  
  4932. The difference between the normal (real-mode) version
  4933. WTRGATE.EXE and the DPMI version WTRGATED.EXE (notice the D)
  4934. is the memory usage. DPMI (DOS protected-mode interface) is a
  4935. memory management standard.
  4936.  
  4937. The real-mode version of WaterGate can only use base memory to
  4938. process a message. (At least, that used to be the case; more
  4939. on swap memory later.)
  4940.  
  4941. If you have 4 megabytes installed, WaterGate will still only
  4942. be able to use the lowest 640 +/- kilobytes of that memory to
  4943. execute and to process a message. Effectively, this means that
  4944. you can only processes messages up to approximatly 150
  4945. kilobytes in size. There is no way to make the real-mode
  4946. version use the rest of the 4 megabytes.
  4947.  
  4948. The DPMI version is capable of doing this. It requires only a
  4949. little bit of programming to have a special version that can
  4950. use all of your installed memory. You need a special DPMI
  4951. memory management program like QEMM or 386MAX for WTRGATED.EXE
  4952. to run. MS-Windows and OS/2 also provide DPMI management, so
  4953. you can run WTRGATED.EXE in a DOS-box on these systems as
  4954. well.
  4955.  
  4956. The disadvantage of DPMI memory usage is the loss of speed.
  4957. All memory related actions in WaterGate will be slowed down a
  4958. little bit, resulting in an overall slower speed.
  4959.  
  4960. Swap memory versus DPMI
  4961. -----------------------
  4962.  
  4963. The option to use Swap Memory was added to WaterGate recently.
  4964. This means that it can use a file on disk to store the message
  4965. it is processing. Because it would be far too slow to always
  4966. store the message data in the swapfile, though, WaterGate only
  4967. uses it when it runs out of memory. It then move all the lines
  4968. it has in memory to the swapfile, freeing up all the memory to
  4969. process more lines.
  4970.  
  4971. The advantage of swap memory is that the overall processing
  4972. speed is better when processing small messages. If you only
  4973. have to process a few big messages every day, the swap file
  4974. might be faster for you.
  4975. WaterGate manual                                        [page 94]
  4976.  
  4977. If you have to process a lot of big messages and you have to
  4978. distribute those messages to a lot of systems, the DPMI
  4979. version might be faster, because it can hold the complete
  4980. message in memory and then write it to every outgoing bundle.
  4981.  
  4982. Swapfile on a RAM-disk
  4983. ----------------------
  4984.  
  4985. Another way to make the real-mode version use all the internal
  4986. memory is by installing a RAM-drive. If you have 4 megabytes,
  4987. for example, you could install a 1 megabyte disk cache and a 2
  4988. megabytes RAM-disk to put the swapfile on.
  4989.  
  4990. This enables you (and WaterGate) to use all the internal
  4991. memory, and a swapfile on a RAM-drive is a lot faster than one
  4992. on a hard-disk. This might lift the overall processing speed
  4993. above that of the DPMI version if there are only a few big
  4994. messages to process.
  4995.  
  4996. A RAM-drive might not be practical under OS/2, since the extra
  4997. memory comes at the expense of other applications and the
  4998. system may wind up swapping the RAM-drive out of memory
  4999. anyway! A large disk cache with write-behind caching might be
  5000. a better idea and, for those using OS/2■s HPFS, increasing the
  5001. size of the CRECL parameter may help with large files.
  5002.  
  5003. Maximum number of file handles
  5004. ------------------------------
  5005.  
  5006. The DPMI version has one more disadvantage: the maximum number
  5007. of file handles that it can use. The real-mode version has the
  5008. option to use over 100 files at the same time. This allows you
  5009. to keep outgoing mail bundles open and thereby reduce disk
  5010. space (WaterGate does this automatically).
  5011.  
  5012. The DPMI version does not allow this, because the DPMI memory
  5013. manager complains and causes a General Protection Fault when
  5014. WaterGate tries to install extra file handles.
  5015.  
  5016. Configuring for WTRGATED.EXE
  5017. ----------------------------
  5018.  
  5019. There is just one little thing you have to look into before
  5020. you can run the DPMI version. The extensions of the
  5021. (de-)compression programs have to entered in, too. This
  5022. probably means that you have to add ".EXE" (or maybe ■*.COM■)
  5023. in all those program configuration fields. You have to do this
  5024. for both the Fido and the UUCP compression and decompression
  5025. programs.
  5026. WaterGate manual                                        [page 95]
  5027.  
  5028. Customizing messages
  5029. --------------------
  5030.  
  5031. Most of the responses WaterGate creates can be configured with
  5032. a language file and several text files. The language file
  5033. contains single-line replies and the text files can contain
  5034. entires explanations.
  5035.  
  5036. The language file
  5037. -----------------
  5038.  
  5039. This is the WTRGATE.LNG text file in your WaterGate system
  5040. directory. Each "language line" contains a number, followed by
  5041. text. Apart from that, you can have empty lines and comment
  5042. lines, which start with a semi-colon (;).
  5043.  
  5044. The numbers in the language file are fixed and all numbers
  5045. must be present, or else WaterGate won't start. Unknown
  5046. numbers or duplicate entries are reported in the logfile.
  5047.  
  5048. The text part of the language line can contain tokens that
  5049. will be replaced with the real item when the line is used.
  5050. These tokens are @1@, @2@ and so on.
  5051.  
  5052. There is no complete description of each language line, when
  5053. it is used and what the tokens will be replaced with. Most of
  5054. the lines are self-explanatory and the tokens can be guessed.
  5055. You will find helping comments where the tokens are not
  5056. directly clear. 
  5057.  
  5058. The text files
  5059. --------------
  5060.  
  5061. Text files are optional. They have special names and the
  5062. extension .TXT and are stored in the sub-directory TXTS of the
  5063. WaterGate System directory, for example C:\WTRGATE\TXTS\.
  5064.  
  5065. When present, these special files are used by WaterGate
  5066. instead of the standard internal response messages, which are
  5067. most of the time just one line.
  5068.  
  5069. With these text files you can customize WaterGate's responses,
  5070. put in more details about the response and of course translate
  5071. them to your own language, if you which.
  5072.  
  5073. Apart from text, you can use special so-called "tokens" in
  5074. these text files. WaterGate replaces these tokens with special
  5075. items, like the current date, etc. But before getting to the
  5076. tokens, let■s have a look at the different .TXT files.
  5077. WaterGate manual                                        [page 96]
  5078.  
  5079. Filenames
  5080. ---------
  5081.  
  5082. Currently, the following .TXT files are supported. Everywhere
  5083. you see "AreaFix", you can also substitute "newsfix".
  5084.  
  5085. File           Description
  5086.  
  5087. AFLSRHDR.TXT   AreaFix LiSt Request HeaDeR.
  5088.                Sent as the header of an AreaFix %LIST request
  5089. reply-message.
  5090.  
  5091. AFLSRFTR.TXT   AreaFix LiSt Request FooTeR.
  5092.                Sent as the footer of an AreaFix %LIST request
  5093.                reply-message.
  5094.  
  5095. AFQRRHDR.TXT   AreaFix QueRy Request HeaDeR.
  5096.                Sent as the header of an Area Manager %QUERY
  5097.                request reply-message.
  5098.  
  5099. AFQRRFTR.TXT   AreaFix QueRy Request FooTeR.
  5100.                Sent as the footer of an Area Manager %QUERY
  5101.                request reply-message.
  5102.  
  5103. BNCFIDO.TXT    BouNCe FIDO.
  5104.                Sent when WaterGate is unable to transport a
  5105.                Fido message.
  5106.  
  5107. BNCGATE.TXT    BouNCe GATEway.
  5108.                Sent when WaterGate is unable to transport a
  5109.                message through the gateway, such as when a
  5110.                FORBID-FIDO statement in the ROUTE.TDB file
  5111.                prevents this user from using the gateway.
  5112.  
  5113. UNKAFUSR.TXT   UNKnown AreaFix USeR.
  5114.                Sent when an unknown user sends a message to
  5115.                AreaFix. A user must be defined in the userbase
  5116.                to use AreaFix.
  5117.  
  5118. WRNGAPWD.TXT   WRoNG AreaFix PassWorD.
  5119.                Sent when an invalid password was found in a
  5120.                message to AreaFix. This is not sent back to
  5121.                the sending user, but to the SysOp of that
  5122.                system.
  5123.  
  5124. LISTHELP.TXT   Help file for a HELP command in a message to
  5125.                the List Server.
  5126.  
  5127. LISTHDR.TXT    LIST HeaDeR.
  5128.                The header of the message created in response
  5129.                to a LIST command in a message to the List
  5130.                Server.
  5131.  
  5132. LISTFTR.TXT    LIST FooTeR.
  5133.                The footer of the message created in response
  5134.                to a LIST command in a message to the List
  5135.                Server.
  5136. WaterGate manual                                        [page 97]
  5137.  
  5138. The following two files are not shared by AreaFix and newsfix;
  5139.                each has a separate file, so you can explain how to address
  5140.                AreaFix or newsfix and use the terms "echomail" and
  5141.                "newsgroups".
  5142.  
  5143. AREAFIX.TXT    Sent as a response to a %HELP request for
  5144.                AreaFix.
  5145.  
  5146. NEWSFIX.TXT    Sent as a response to a %HELP request for
  5147.                newsfix.
  5148.  
  5149. Tokens
  5150. ------
  5151.  
  5152. Each .TXT file may contain any of the tokens listed below,
  5153. although some may be empty when used. PASSWORD, for example,
  5154. will be an empty string when not used in conjunction with
  5155. WRNGAPWD.TXT.
  5156.  
  5157. Token               Description
  5158.  
  5159. FirstUserName       Message sender's first name
  5160. LastUserName        Message sender's last name
  5161. UserName            Message sender's full name
  5162. Subject             Subject of sent message
  5163.  
  5164. Password            AreaFix password found
  5165.  
  5166. Date                Current system date
  5167. Time                Current system time
  5168. WeekDay             Current day of the week
  5169. FromAddress         Address used by the original sender
  5170. ToAddress           Address used by us for the reply
  5171.  
  5172. SysOp               SysOp name found in the configuration
  5173. SysopFirst          Sysop's first name
  5174. AreaName            Current message area
  5175. PID                 Our program ID (WaterGate)
  5176. Version             Current program revision (0.20 beta)
  5177.  
  5178. To use a token, put it between @ characters. For example, if
  5179. you want to use the SysOp token, put the string @Sysop@ in
  5180. your textfile.
  5181. WaterGate manual                                        [page 98]
  5182.  
  5183. Using a secondary tosser
  5184. ------------------------
  5185.  
  5186. This chapter explains how to use a second tosser together with
  5187. WaterGate, as I have received a lot of questions about this.
  5188.  
  5189. You might have a perfectly running Fido setup right now, with
  5190. a tosser that takes care of your complete distribution. Now,
  5191. you also want to connect to UUCP, and you want to use
  5192. WaterGate to do this, but you don't want to replace your
  5193. complete system. This is perfectly possible.
  5194.  
  5195. You can configure WaterGate to do all the translation work
  5196. between UUCP and Fidonet while your other tosser continues to
  5197. take care of the distribution to all your nodes and points.
  5198.  
  5199. The best thing to do is to use a different zone for the UUCP
  5200. newsgroups. The gateway will have its own address in this zone
  5201. and it will be very clear that netmail messages sent to that
  5202. one address are going to another network, in this case to
  5203. UUCP. Then create a user that represents your other tosser and
  5204. give it its own AKA. Connect the user to the areas that you
  5205. want to feed.
  5206.  
  5207. Next you need to connect WaterGate's outbound to the inbound
  5208. of your current tosser. Be careful not to set these to the
  5209. same directory! If you do, when WaterGate creates a .PKT file
  5210. it might overwrite an already present .PKT file in that
  5211. directory.
  5212.  
  5213. It is also dangerous to just copy all the .PKT files from
  5214. WaterGate's outbound to your tosser's inbound directory, again
  5215. because you might overwrite an already present .PKT file.
  5216.  
  5217. The best way to solve this is to let WaterGate archive its
  5218. outbound, then copy this file to the inbound of your tosser
  5219. and let your tosser extract the archive when it is ready for
  5220. it. If it is a good tosser, it first processes all the .PKT
  5221. files in the inbound directory and then starts to extract an
  5222. archive, process all the .PKT files again, etc.
  5223.  
  5224. I hear you saying: but archiving takes a long time. You could,
  5225. of course, force the compression factor to 0, so your archiver
  5226. just puts all the .PKT files together. ARJ has the option -m0
  5227. for this. And, since there■s no other point or node for which
  5228. WaterGate has to create archives (possibly archives with ARJ),
  5229. it is no problem to change the arguments for ARJ.
  5230.  
  5231. If you do want to use ARJ for a node anyway, you might also
  5232. use the OP1 option to compress for your other tosser and put
  5233. the special commandline arguments there.
  5234.  
  5235. On the way back, you could perfectly well copy the .PKT files
  5236. to WaterGate's inbound, but you probably don't know the names
  5237. of these .PKT files, because these are taken randomly. So, you
  5238. have to archive everything again.
  5239. WaterGate manual                                        [page 99]
  5240.  
  5241. Statistical information
  5242. -----------------------
  5243.  
  5244. To let you know what passes through your system, WaterGate
  5245. keeps track of all mail that passes through your system. It
  5246. counts the size and amount of all messages - both received and
  5247. sent - and stores that information in a separate logfile,
  5248. called WTRGATE.STA by default. This file is located in the
  5249. same directory you choose for the logfile. It also uses the
  5250. name of the logfile, but with the extension .STA. New
  5251. information is appended to it after each run of WaterGate.
  5252.  
  5253. Format of the WTRGATE.STA file
  5254. ------------------------------
  5255.  
  5256. A sample entry:
  5257.  
  5258. Statistics report of toss on Mon 05 Jun 1995 21:37:54
  5259.  m 1952 dutchman@mbh.network.nl (Jaap Aap%2:280/802.6)
  5260.  m 1210 sysop@waste.bin.network.nl (Jaap Aap%2:280/802.6)
  5261.  n 894 Jaap Aap%2:280/802.6 (dutchman@mbh.network.nl)
  5262.  u 0 0 0 0 0 0 0 49546 2:512/17@fidonet.org (Piet Hein)
  5263.  v 0 0 0 0 0 0 0 14 2:512/17@fidonet.org (Piet Hein)
  5264.  u 0 0 0 0 0 0 0 2263 LOCAL
  5265.  v 0 0 0 0 0 0 0 1 LOCAL
  5266.  b 2263 1 WLINK.TEST
  5267.  b 12778 3 HOLLAND.SYSOP
  5268.  b 733 1 POINTS.028
  5269.  b 3124 2 OVERIG.028
  5270.  b 6328 5 FS.028
  5271.  b 643 1 FDECHO.028
  5272.  b 3309 2 ALT.BBS.WATERGATE
  5273.  
  5274. The first line contains the date and time of the run. When a
  5275. new statistics file is started, WaterGate will write a short
  5276. explanation of the different lines, so the first line could be
  5277. followed by a number of information lines, but these all start
  5278. with a space.
  5279. Each line that starts with the letter 'u' or 'v' contains
  5280. information about a user that sent or received messages during
  5281. the run. Only users that either sent or received messages are
  5282. shown. The 'u' lines holds the number of bytes sent/received
  5283. and the 'v' line holds the number of messages sent/received.
  5284.  
  5285. Each 'u' or 'v' line has the following fields:
  5286.  
  5287.      MailTo    UUCP mail sent to this node
  5288.      MailFrom  UUCP mail received from this node
  5289.      NewsTo    UUCP news sent to this node
  5290.      NewsFrom  UUCP news sent received from this node
  5291.      NetTo     Fidonet netmail sent to this node
  5292.      NetFrom   Fidonet netmail received from this node
  5293.      EchoTo    Fidonet echomail sent to this node
  5294.      EchoFrom  Fidonet echomail received from this node
  5295.      Name      User identification, plus SysOp name or
  5296.                UUCPname between the braces. Messages that
  5297.                originate from a messagebase are counted as
  5298.                "LOCAL".
  5299. WaterGate manual                                        [page 100]
  5300.  
  5301. The flow of messages in each area is shown in the 'b' lines.
  5302.                The old 'a' lines are now obsolete and not produced anymore.
  5303.                Every 'b' line contains the traffic in that area in number of
  5304.                bytes and number of messages and the name(s) of the area.
  5305.                Again, only areas that had any traffic are shown.
  5306. When an area has a different name for Fidonet and UUCP, then
  5307. the UUCP name is listed as second name as well. The exact
  5308. format of the 'b' line is:
  5309.  
  5310. "b" space <flow in bytes> space <number of messages> space
  5311. <fidonet area name> [space <uucp area name>]
  5312.  
  5313. Between the [ and ] is optional.
  5314.  
  5315. Each netmail and mail message passing through your system is
  5316. tracked in the 'm' (mail)  and 'n' (netmail) lines. This is
  5317. information on netmail and mail messages and their size. The
  5318. MsgTo and MsgFrom field contain the destination and source
  5319. address of the message, for fido messages as username%fidoaddr
  5320. and for UUCP messages as user@domain.
  5321.  
  5322. The WtrStat program
  5323. -------------------
  5324.  
  5325. You can use WTRSTAT.EXE, included in the WaterGate archive, to
  5326. process the statistics file and make ASCII graphs of the
  5327. message traffic passing through your system. If you want
  5328. graphs number 1, 2, and 3 created, you can start the program
  5329. with the following command:
  5330.  
  5331.  C:\MAIL\LOGS>wtrstat wtrgate.sta 1 2 3
  5332.  
  5333. WTRSTAT will create the files GRAPH1.TXT, GRAPH2.TXT, and
  5334. GRAPH3.TXT in the program startup directory.
  5335.  
  5336. Possible graphs
  5337. ---------------
  5338.  
  5339. The program is capable of proceding eight different graphs:
  5340.  
  5341. Graph 1:  Message traffic (in kilobytes) in each of the areas.
  5342.  
  5343. Graph 2:  Size (in kilobytes) and a graphical overview of the
  5344.           traffic from this system to each other system.
  5345.  
  5346. Graph 3:  Size (in kilobytes) and a graphical overview of the
  5347.           traffic from each other system to this system.
  5348.  
  5349. Graph 4:  Flow in each area and the total flow in all of the
  5350.           areas, for as far as there has been a flow in those
  5351.           areas.
  5352.  
  5353. Graphs 5 through 8 are the same as graphs 1 through 4, but
  5354. hold the information in number of messages, instead of number
  5355. of (kilo)bytes.
  5356. WaterGate manual                                        [page 101]
  5357.  
  5358. Command line options
  5359. --------------------
  5360.  
  5361. The program accepts a number of options as well. Options have
  5362. to be preceeded with a forward slash (/) or dash (-). The
  5363. following options can be used:
  5364.  
  5365. -D<n>     "Days". Makes a report for the last <n> days,
  5366.           starting to count with today=1. -D1 creates a report
  5367.           over today, up to the last data added. -D7 creates a
  5368.           report for the last week, including today.
  5369.  
  5370. -A        "Amount". Sorts the area listing in graph 4 or 8 by
  5371.           amount, in descending order. The area with the
  5372.           highest number of messages or bytes is shown first,
  5373.           and so on.
  5374.  
  5375. -N        "Name" With this option you can tell WtrStat to use
  5376.           the UUCP area name in graphs 4 and 8, instead of the
  5377.           Fidonet areaname.
  5378.  
  5379. The WtrStat program will first get and check all the command
  5380. line options, then read the statistics file to gather all the
  5381. information and finally create all the requested graphs.
  5382. WaterGate manual                                        [page 102]
  5383.  
  5384. Translating from other programs
  5385. -------------------------------
  5386.  
  5387. WaterGate is capable of adding information to its userbase and
  5388. areabase from other programs. Currently, it can directly
  5389. process information from GEcho, Waffle, and Squish. To do
  5390. this, start the "WTRCONF" program and select the
  5391. "Import/Export" menu option.
  5392.  
  5393.  
  5394. Adding information from Gecho v1.02
  5395. -----------------------------------
  5396.  
  5397. First select the "Import GEcho Nodes file NODEFILE.GE" option.
  5398. This will read all node information stored by GEcho and add
  5399. this information to the WaterGate userbase. You have to do
  5400. this first because without this node information WaterGate is
  5401. unable to add these nodes to the area lists when using the
  5402. "Import Gecho Areas file AREAFILE.GE" that you can use next.
  5403.  
  5404.  
  5405. Adding information from Waffle
  5406. ------------------------------
  5407.  
  5408. First select the "Import Usenet newsgroups file", this file is
  5409. usually located in your waffle\system directory and contains a
  5410. listing of all the areas available on your system.
  5411.  
  5412. A typical file looks like :
  5413.  
  5414. # All Areas that I ever want to read (Not!)
  5415. #
  5416. COMP.BBS.PROGRAMS
  5417. COMP.BBS.NONEWBBS  /mod=jaap@aap.network.nl
  5418.  
  5419. Next import the SYSTEMS file, containing the names of all
  5420. systems that are directly linked to your system.
  5421.  
  5422. A typical SYSTEMS file entry looks like:
  5423.  
  5424. steambt  Any  g modemx tosystem 02995-9111 myid password
  5425.  
  5426. All information about mail that needs to be sent through
  5427. another system is located in the PATHS file, usually located
  5428. in the "WAFFLE\UUCP" directory. Use "Import Usenet Paths" file
  5429. to import this information.
  5430.  
  5431. To add areas for certain users, select "Import UUCICO Feeds".
  5432. This file contains information about all users connected to
  5433. certain areas.
  5434.  
  5435. A typical entry is:
  5436.  
  5437. steambk /batch comp.bbs.*,alt.bbs.*
  5438. steambt /batch *
  5439. WaterGate manual                                        [page 103]
  5440.  
  5441. Adding Information from Squish
  5442. ------------------------------
  5443.  
  5444. WaterGate is capable of scanning a Squish configuration file
  5445. (usually SQUISH.CFG) for 'EchoArea' lines.
  5446.  
  5447. A typical Squish EchoArea entry:
  5448.  
  5449. EchoArea MUFFIN      D:\WTRGATE\SQUISH\MUFFIN -$ -$m200 -$d5
  5450. EchoArea POINTS.028  D:\WTRGATE\SQUISH\PNT028 -$ -$m200 -$d5
  5451.  
  5452. WaterGate understands the -$, -0 and -F area types, to
  5453. indicate a Squish, passthrough and *.MSG area style. In
  5454. addition, the -J switch is also used to indicate JAM style
  5455. areas.
  5456.  
  5457. When using the "Export Squish like Area config", as a
  5458. non-standard addition, JAM areas are also exported using this
  5459. '-J' option, but each line is preceded with a ';' to make sure
  5460. other programs ignore those lines.
  5461.  
  5462. The "Import/Export" menu has another option, called "Import
  5463. AREAS.BBS file", which is useful if you want to delete a
  5464. certain node from a list of areas without using the normal
  5465. 'tag & delete' options. You can use another program to prepare
  5466. a file containing a list of areas that have to be added or
  5467. deleted. When you select a file, you are asked for which user
  5468. you want to make these modifications.
  5469.  
  5470. The format of the input file:
  5471.  
  5472.      +ARENA         ; Add an area
  5473.      +CHESS.INT     ; Add an area
  5474.      -POINTS.028    ; Delete an area
  5475.      ....           ; etc etc
  5476.  
  5477. Note: No '%' commands for normal AreaFix operation are
  5478. available.
  5479. WaterGate manual                                        [page 104]
  5480.  
  5481. Commandline parameters
  5482. ---------------------
  5483.  
  5484. WTRGATE.EXE
  5485. -----------
  5486.  
  5487. This is the main program. It must be correctly configured to
  5488. run; the program will exit if it is unable to initialize. To
  5489. create new configuration files, or modify an existing
  5490. configuration, use the WtrConf program.
  5491.  
  5492. You can start WaterGate using a commandline option or you can
  5493. start it without one and select an option from the menu. Only
  5494. a single commandline option is available for each run.
  5495.  
  5496. When scanning for outgoing Fido echomail messages, the program
  5497. will look for an ECHOTOSS.LOG or ECHOMAIL.JAM file in its
  5498. system directory, containing a listing of the areas it has to
  5499. scan.
  5500.  
  5501. Commandline    Functions
  5502.  
  5503. ?              Display a short help screen.
  5504.  
  5505. TOSSFIDO       Process any mail that is located in the inbound
  5506.                directories.
  5507.  
  5508. SCANFIDO       Scan the local message bases for unsent
  5509.                outgoing mail.
  5510.  
  5511. TOSSUSE        Process any new mail located in the spool
  5512.                directories.
  5513.  
  5514. -NONETSCAN     Skip the scanning of all netmail areas.
  5515.  
  5516. -NOECHOSCAN    Skip the scanning of all echomail areas. A
  5517.                shorter alias for this option is -NOES.
  5518.  
  5519. -NONETMAIL     Do not route netmail messages; store them in
  5520.                the local netmail area instead.
  5521.  
  5522. -NOEXPORT      Do not export messages to other systems; only
  5523.                import local messages.
  5524.  
  5525. -NOLOCAL       Don't import local messages; only export them
  5526.                to up and downlinks.
  5527.  
  5528. -NODUPE        Force dupe checking off.
  5529.  
  5530. -NOCHECK       Force WaterGate to ignore the directory check
  5531.                at startup.
  5532.  
  5533. -NONEWSTOSS    Do not toss Usenet news batches, only e-mail.
  5534.  
  5535. -KEEPFA        Keep file attach netmail when the attached file
  5536.                cannot be found. This can used for busy LANs
  5537.                that report a file as "not found" when actually
  5538.                the LAN is to busy.
  5539. WaterGate manual                                        [page 105]
  5540.  
  5541. -MEMUSAGEReport in the logfile the amount of memory used
  5542.                for each of the configuration table that are
  5543.                loaded at start-up. This will help you
  5544.                understand WaterGate's memory consumption.
  5545.  
  5546. Errorlevel returns 0 on success or >1 on failure.
  5547.  
  5548. WTRCONF.EXE
  5549. -----------
  5550.  
  5551. You will need this program to configure WaterGate; it is
  5552. capable of creating and modifying configuration files,
  5553. including the areabase and userbase files. For more
  5554. information see "Installing WaterGate"
  5555.  
  5556. Commandline                   Function
  5557.  
  5558. EXPORT_SQUISH [file]     Exports a SQUISH.CFG file containing
  5559.                          all areas defined in the
  5560.                          configuration. Or use [file] to
  5561.                          specify another file name.
  5562.  
  5563. EXPORT_AREAS [file]      Exports an AREAS.BBS file containing
  5564.                          all areas defined in the
  5565.                          configuration. Or use [file] to
  5566.                          specify another file name.
  5567.  
  5568. IGNORE_SYSTEMDIR         WaterGate will ignore the System
  5569.                          Directory as configured in
  5570.                          WTRCFG.TDB. This allows you to use a
  5571.                          configuration in an other directory
  5572.                          than the orignal. Useful when
  5573.                          checking somebody else's databases.
  5574.  
  5575. Errorlevel returns 0 on success or >1 on failure.
  5576.  
  5577. WTRUTIL.EXE
  5578. -----------
  5579.  
  5580. WaterGate comes with a messagebase maintenance utility called
  5581. WtrUtil. It can link messages in all area types; remove
  5582. messages that are too old or over the maximum number of
  5583. messages in an area; create new index files for both Squish
  5584. and Jam bases; and renumber *.MSG areas.
  5585.  
  5586. You can start WtrUtil with commandline options, or start it
  5587. without one and simply select from the menu.
  5588.  
  5589. Commandline    Function
  5590.  
  5591. ?              Show all commandline options.
  5592.  
  5593. DATABASE       Removes deleted entries and unused links from
  5594.                all WaterGate's configuration files, rebuild
  5595.                the databases and sort the areabase for faster
  5596.                access by WtrConf. Use -NOSORT to prevent the
  5597.                areabase from being sorted.
  5598. WaterGate manual                                        [page 106]
  5599.  
  5600. INDEXCreates new index files for all Squish and JAM
  5601.                message bases.
  5602.  
  5603. LINK           Links messages in all areas.
  5604.  
  5605. RENUM          Renumbers all *.MSG areas.
  5606.  
  5607. RENUMJAM       Renumbers all JAM areas.
  5608.  
  5609. PURGE          Removes messages by number and date from all
  5610.                message bases.
  5611.  
  5612. IMPORT         This function imports messages from your *.MSG
  5613.                main netmail directory into a JAM or Squish
  5614.                netmail area.
  5615.  
  5616.                IMPORT AREANAME [Address] [-NoKill]
  5617.  
  5618.                AREANAME specifies the name of the netmail base
  5619.                to which the messages are to be imported.
  5620.  
  5621.                Address specifies the AKA to which the messages
  5622.                have to be addressed to be selected for import.
  5623.                This parameter is optional; if not specified
  5624.                all your AKA■s are used.
  5625.  
  5626.                The -NoKill parameter ensures that the imported
  5627.                messages are not removed from your netmail
  5628.                directory, which is the default.
  5629.  
  5630. SHRINKLOG n    This function will clean the logfile and all
  5631.                leaving only today■s plus n days of history, as
  5632.                supplied on the commandline. For example,
  5633.                SHRINKLOG 6 will keep a whole week in the
  5634.                logfile.
  5635.  
  5636. -NOSLICE       Use this option to disable the time slicing
  5637.                support, in case it causes problems, or when
  5638.                you want to speed up processing without giving
  5639.                up time slices anymore.
  5640.  
  5641. Errorlevel returns 0 on success or >1 on failure.
  5642.  
  5643. Use the DATABASE option if you have removed large numbers of
  5644. areas or users from your configuration. Letting them stay in
  5645. the base only wastes memory and disk access time.
  5646.  
  5647. Since WtrConf has to sort the list of area names all the
  5648. times, you can speed up the editting work in WtrConf greatly
  5649. by sorting the areabase with WtrUtil on a regular basis, for
  5650. example every night.
  5651. WaterGate manual                                        [page 107]
  5652.  
  5653. Groups filter option
  5654. --------------------
  5655.  
  5656. To limit the number of areas that WtrUtil processes during the
  5657. INDEX, LINK, PURGE, RENUM and RENUMJAM options, you can add an
  5658. extra command line argument to these options to tell WtrUtil
  5659. which groups to process only.
  5660.  
  5661. For example:
  5662.  
  5663. WTRUTIL LINK        Links messages in all areas.
  5664. WTRUTIL LINK ABC    Links messages in areas that are in one of
  5665.                     the groups A B and C.
  5666.  
  5667. Notice that the groups filter option only works when using the
  5668. five functions from the command line.
  5669. WaterGate manual                                        [page 108]
  5670.  
  5671. WTRSTAT.EXE
  5672. -----------
  5673.  
  5674. WTRSTAT processes the statistics file and makes ASCII graphs
  5675. of the message traffic passing through your system. Since it
  5676. needs to read the statistics logfile, which is named
  5677. WTRGATE.STA by default, the first argument of the program is
  5678. the full path to this file.
  5679.  
  5680. Next, select the graphs you want the program to produce.
  5681. Currently, there are four graphs, numbered 1, 2, 3 and 4,
  5682. corresponding to output files named GRAPH1.TXT to GRAPH4.TXT.
  5683. You have to put the numbers on the commandline after the path
  5684. to the statistics file.
  5685.  
  5686. Example:
  5687.  
  5688.      WTRSTAT C:\WTRGATE\WTRGATE.STA 1 2 3 4
  5689.  
  5690. The graphs contain the following information:
  5691.  
  5692. Graph 1:  Message traffic (in kilobytes) to and from each of
  5693.           the system.
  5694.  
  5695. Graph 2:  Size (in kilobytes) and a graphical overview of the
  5696.           traffic from this system to each other system.
  5697.  
  5698. Graph 3:  Size (in kilobytes) and a graphical overview of the
  5699.           traffic from each other system to this system.
  5700.  
  5701. Graph 4:  Traffic in each of the areas in bytes, with the
  5702.           total flow in all the areas at the end in bytes,
  5703.           kilobytes and megabytes.
  5704.  
  5705. Graphs 5 to 8 show the same graphs as 1 to 4, but then with
  5706. the number of messages, instead of the flow in kilobytes.
  5707. WaterGate manual                                        [page 109]
  5708.  
  5709. Appendixes
  5710. ----------
  5711.  
  5712. Appendix A: Message Bases
  5713. -------------------------
  5714.  
  5715. If you receive messages, you will need a place to store them.
  5716. WaterGate has built in support for three different messagebase
  5717. types, each with its own characteristics. None of the
  5718. supported bases puts more than one area into the same base, so
  5719. if one area crashes for some reason, you won't lose more than
  5720. just that area.
  5721.  
  5722. Both the Squish base and the JAM base can be considered
  5723. successors to the Hudson Message Base. The HMB was a
  5724. replacement for the Fido *.MSG base, but its limit of 200
  5725. message areas and maximum size of 16Mb makes it somewhat
  5726. outdated compared to the huge message traffic produced by the
  5727. various networks today. The Hudson Message Base is not
  5728. supported by WaterGate.
  5729.  
  5730. Fido *.MSG
  5731. ----------
  5732.  
  5733. This is the oldest format, and is defined by FTS-0001. This
  5734. format needs a sub-directory for each defined area. Every
  5735. message is put into a single file, so this format is not
  5736. recommended for areas that receive lots of messages,
  5737. especially when using standard DOS FAT formatted harddisks.
  5738. These become incredibly slow when the number of files in a
  5739. single directory exceeds 256.
  5740.  
  5741. This type of base is compatible with almost any piece of
  5742. software written for Fido. So you probably want to use it for
  5743. your netmail directory, to allow other programs to easily
  5744. insert messages.
  5745.  
  5746. If you create a Fido *.MSG area, make sure you enter a valid
  5747. directory name in the "Area path" field, with a terminating
  5748. backslash.
  5749.  
  5750. Example:  C:\WSD\NETMAIL\
  5751.           C:\WSD\NETMAIL\HISTORY
  5752.  
  5753.  
  5754. Squish
  5755. ------
  5756.  
  5757. Squish was designed in 1990 by Scott Dudley, and it is used in
  5758. his Maximus BBS package and Squish mail processor. It uses 4
  5759. different files for each area: <name>.SQD contains the
  5760. messages and header information; <name>.SQI contains an index
  5761. to the messages in the SQD file; <name>.SQL contains lastread
  5762. pointers for BBS users; and <name>.SQB contains dupecheck
  5763. information. The SQB file is not used by WaterGate.
  5764. WaterGate manual                                        [page 110]
  5765.  
  5766. A Squish base can contain up to 2^32 (2 to the 32nd power)
  5767. messages, which should be enough for anybody. (Don't quote me
  5768. on this one, please.) If it isn't, you probably have more
  5769. serious problems.
  5770.  
  5771. A Squish base can re-use space occupied by deleted messages
  5772. without needing repacking, so you don't need to pack a Squish
  5773. base as often as other types.
  5774.  
  5775. If you set a maximum number of messages for a Squish area,
  5776. WaterGate will automatically delete the oldest message. So,
  5777. the area never contains more than the set number of messages.
  5778. Don't set this number too low, because if WaterGate has to
  5779. delete large numbers of messages in each run, performance will
  5780. suffer. If you want maximum performance and don't care about
  5781. disk space, just set the limit to 0 messages.
  5782.  
  5783. If you use the Squish base for an area, the "Area Path" should
  5784. contain a valid directory plus an 8 character area name. Don't
  5785. use any extensions (.???) in the path and don't put a
  5786. backslash at the end!
  5787.  
  5788. Examples:
  5789.  
  5790.      C:\BBS\SQUISH\ALTBBS     for the area ALT.BBS
  5791.      C:\BBS\SQUISH\ALTBMISC   for the area ALT.BBS.MISC
  5792.      etc.
  5793.  
  5794. JAM
  5795. ---
  5796.  
  5797. JAM was designed in 1993 by Joaquim Homrighausen, Andrew
  5798. Milner, Mats Birch, and Mats Wallin. Like Squish, it is
  5799. designed to support up to 2^32 messages in a single message
  5800. area and uses 4 different files.
  5801.  
  5802. It uses a <name>.JHR file to store header information; each
  5803. header consists of a fixed part and a flexible part, depending
  5804. on the message. Storing only a small part in the fixed header
  5805. makes it relatively easy to add future enhancements to the
  5806. message base. Each header contains a pointer into the
  5807. <name>.JDT file, which contains the actual message. The
  5808. areabase is indexed in the <name>.JDX file and lastread
  5809. information is stored into the <name>.JLR file.
  5810.  
  5811. JAM has a (for Fido systems) new way of linking messages:
  5812. instead of simply linking messages with the same subject, each
  5813. message can have an unlimited number of replies to it, so that
  5814. each reply is a reply to the original message. This way you
  5815. can always see to which message a new message is a reply.
  5816. WaterGate manual                                        [page 111]
  5817.  
  5818. Example:1 --- 2 --- 4 --- 5
  5819.                |     |
  5820.                |     +---- 8
  5821.                |
  5822.                +---- 3 --- 7
  5823.                |
  5824.                +---- 6
  5825.  
  5826. Messages 2, 3, and 6 are a reply to message 1. Message 4 and 8
  5827. are a reply to message 2. Message 5 is a reply to message 4.
  5828. Message 7 is a reply to message 3.
  5829.  
  5830. If you use the JAM base for an area, the "Area Path" should
  5831. contain a valid directory plus an 8 character area name. Don't
  5832. use any extensions (.xxx) in the path and don't use a
  5833. terminating backslash!
  5834.  
  5835. Examples:
  5836.  
  5837.      C:\BBS\JAM\ALTBBS        for the area ALT.BBS
  5838.      C:\BBS\JAM\ALTBMISC      for the area ALT.BBS.MISC
  5839.      etc.
  5840. WaterGate manual                                        [page 112]
  5841.  
  5842. Appendix B: Error codes
  5843.  
  5844. Below is a description for most of the error numbers that
  5845. WaterGate writes in the logfile. This helps you understand the
  5846. error better.
  5847.  
  5848. Code Description
  5849.  
  5850. 2    File not found
  5851. 3    Path not found
  5852. 4    Too many open files
  5853. 5    File access denied
  5854. 100  Disk read error
  5855. 101  Disk write error
  5856. 150  Disk is write-protected
  5857. 158  Sector not found
  5858. 200  Division by zero
  5859. 202  Stack overflow error
  5860. 216  General Protection fault
  5861. WaterGate manual                                        [page 113]
  5862.  
  5863. Appendix C: TradeMarks
  5864.  
  5865. All trademarks are owned by their respective owners,
  5866.  
  5867. ARC,ZIP             PkWare, Inc
  5868. ARJ                 Robert K. Jung
  5869. Binkley             Bit Bucket Software Co.
  5870. Fido                Tom Jennings
  5871. FrontDoor           Advanced Engineering Sarl
  5872. GEcho               Gerard J. van der Land
  5873. JAM (mbp)           Joaquim Homrighausen, Andrew Milner,
  5874.                     Mats Birch, Mats Wallin
  5875. LHA                 Haruyasu Yoshizaka
  5876. MS-DOS              Microsoft Corporation
  5877. PAK                 NoGate Consulting
  5878. PC-DOS,OS/2         IBM
  5879. Pentium             Intel
  5880. Squish,Maximus      Scott J. Dudley
  5881. TimEd               Gerard van Essen
  5882. Waffle              DarkSide International
  5883.